Add AI-Powered Trending Audio Recommendations to the Instagram Reel Wizard

#ai #instagram #python #webdev

Add AI-Powered Trending Audio Recommendations to the Instagram Reel Wizard

When you automate Reel creation, video ideas and stock footage are only part of the workflow. Audio is usually what turns a plain clip sequence into something that actually feels native to Instagram. That was the gap this issue was solving.

In Reel Quick, the wizard could already research content ideas and supporting visuals, but creators still had to leave the flow, open Instagram manually, and hunt for trending audio on their own. That breaks momentum. It also creates a mismatch between an AI-generated Reel concept and the music or original audio that gives the Reel its final shape.

This issue adds a dedicated Step 3 that researches trending Instagram audio for a niche and research period, then returns a structured JSON payload with ranked recommendations, evidence, and relevance scoring.

The Problem

Before this change, the wizard could help a creator answer:

What should I post?
What trend should I build around?
What visual direction should I use?

But it could not answer:

What audio should I search for inside Instagram when I publish the Reel?

That missing step matters because audio on Instagram is not interchangeable. A Reel about comeback stories, gym progress, or business motivation usually performs differently depending on whether the selected audio matches what creators are already using in that niche.

So the problem was not "find any song." The problem was "find currently trending Instagram audio that is relevant to a specific niche and backed by public evidence."

What This Step Solves

The new Step 3 audio search does four things:

Accepts a niche, start date, end date, and result limit.
Uses AI plus web research to find trending Instagram audio during that period.
Returns ranked recommendations with citations and relevance scoring.
Gives creators enough metadata to search the audio directly inside Instagram.

That makes the wizard useful later in the workflow, not just at the ideation stage.

Why The System Does Not Download Audio

This is the most important implementation constraint.

Instagram does not provide an API that lets us reliably fetch Reel audio files or public downloadable audio links for trending sounds. Even when a public Instagram audio page exists, that does not mean there is a supported downloadable media URL exposed for app developers.

There are also product and compliance reasons not to do this:

Instagram audio is platform-controlled content.
Licensing terms vary by region, creator, and audio source.
Public Reel/audio pages are not a supported contract for direct media ingestion into third-party apps.
The goal of this feature is recommendation, not redistribution.

So the feature deliberately stops at recommendation.

The app can tell the creator:

which audio is trending
why it fits the niche
where the evidence came from
what type of Reel it is good for

But the creator still needs to open Instagram, search for the recommended audio, and attach it while creating the Reel in the Instagram app.

That design is intentional. It keeps the workflow realistic and aligned with how Instagram actually exposes audio.

Technical Approach

The Step 3 backend now uses a prompt-driven research flow that asks the model to:

search within a specific historical window
avoid fabricated songs, artists, dates, URLs, and citations
prefer multiple independent sources
return strict JSON
explain why each audio recommendation fits the niche

The backend validates the model response and stores a normalized structure shaped like:

wizard_id
query
input_values
audio

The audio.results array contains the recommendations, including:

rank
audio_name
artist_name
audio_type
relevance_score
trend_confidence_score
best_for
why_selected
evidence

This gives the frontend a clean contract for rendering audio suggestions without having to parse free-form text.

Example Output JSON

The following is the sample output saved in docs/wizard_step_3.json:

{
  "_id": "6a754df164ad86c595f2c3e5",
  "wizard_id": "6a6634287bef448b20420ad5",
  "niche": "motivation videos",
  "research_period": {
    "start_date": "2026-06-01",
    "end_date": "2026-07-20"
  },
  "maximum_results": 10,
  "status": "completed",
  "research_result_json": {
    "wizard_id": "6a6634287bef448b20420ad5",
    "query": {
      "niche": "motivation videos",
      "start_date": "2026-06-01",
      "end_date": "2026-07-20",
      "maximum_results": 10
    },
    "input_values": {
      "niche": "motivation videos",
      "start_date": "2026-06-01",
      "end_date": "2026-07-20",
      "limit": 10
    },
    "audio": {
      "niche": "motivation videos",
      "research_period": {
        "start_date": "2026-06-01",
        "end_date": "2026-07-20"
      },
      "generated_at": "2026-08-07T03:16:09Z",
      "results": [
        {
          "rank": 1,
          "audio_name": "Resiliencia",
          "artist_name": "Rantseni",
          "audio_type": "song",
          "relevance_score": 97,
          "trend_confidence_score": 88,
          "best_for": [
            "how-it-started versus how-it-is-going transformations",
            "discipline, recovery, and personal-growth montages"
          ],
          "why_selected": "A July 2026 Instagram trend archive directly identifies this audio with motivational progress builds. Its resilience theme closely matches transformation, persistence, comeback, and self-improvement Reels.",
          "evidence": [
            {
              "source_name": "SocialPilot",
              "source_type": "trend_report",
              "published_or_updated_date": "2026-07-27",
              "url": "https://www.socialpilot.co/blog/instagram-reels-trends",
              "supports": "Lists Resiliencia by Rantseni in the July archive and associates it with motivational how-it-started versus how-it-is-going builds."
            },
            {
              "source_name": "Instagram",
              "source_type": "instagram_audio_page",
              "published_or_updated_date": null,
              "url": "https://www.instagram.com/reels/audio/722903805204295/",
              "supports": "Direct Instagram audio page linked by the trend report for the identified recording."
            }
          ]
        },
        {
          "rank": 2,
          "audio_name": "Goals",
          "artist_name": "LISA, Anitta & Rema",
          "audio_type": "song",
          "relevance_score": 93,
          "trend_confidence_score": 86,
          "best_for": [
            "ambition and goal-setting montages",
            "career, fitness, and achievement highlights"
          ],
          "why_selected": "The June trend archive explicitly connects this World Cup audio with ambition montages. Its energetic theme supports goal announcements, training sequences, milestone recaps, and achievement-focused motivational edits.",
          "evidence": [
            {
              "source_name": "SocialPilot",
              "source_type": "trend_report",
              "published_or_updated_date": "2026-07-27",
              "url": "https://www.socialpilot.co/blog/instagram-reels-trends",
              "supports": "Includes Goals in its June 2026 archive and describes its Reel format as ambition montages and a dance challenge."
            },
            {
              "source_name": "Instagram",
              "source_type": "instagram_audio_page",
              "published_or_updated_date": null,
              "url": "https://www.instagram.com/reels/audio/1460390505443280/",
              "supports": "Direct Instagram audio page for the track cited in the June trend archive."
            }
          ]
        },
        {
          "rank": 3,
          "audio_name": "Wings (Sped Up)",
          "artist_name": "Birdy",
          "audio_type": "remix",
          "relevance_score": 90,
          "trend_confidence_score": 84,
          "best_for": [
            "graduation and milestone slideshows",
            "personal progress and new-chapter Reels"
          ],
          "why_selected": "This sped-up version was documented as a June trend for graduation and milestone slideshows, making it especially suitable for motivational stories about progress, growth, accomplishment, and entering a new life chapter.",
          "evidence": [
            {
              "source_name": "SocialPilot",
              "source_type": "trend_report",
              "published_or_updated_date": "2026-07-27",
              "url": "https://www.socialpilot.co/blog/instagram-reels-trends",
              "supports": "Lists Wings (Sped Up) by Birdy among June trends for graduation and milestone slideshow formats."
            },
            {
              "source_name": "Instagram",
              "source_type": "instagram_audio_page",
              "published_or_updated_date": null,
              "url": "https://www.instagram.com/reels/audio/500331368617006/",
              "supports": "Direct Instagram audio page linked for the sped-up recording."
            }
          ]
        },
        {
          "rank": 4,
          "audio_name": "Freakin’ Out",
          "artist_name": "Dexter and The Moonrocks",
          "audio_type": "song",
          "relevance_score": 88,
          "trend_confidence_score": 82,
          "best_for": [
            "identity and self-belief montages",
            "confidence-restoration and comeback edits"
          ],
          "why_selected": "The documented “remember who you are” format strongly aligns with self-belief and identity-based motivation. It can frame setbacks, rediscovering confidence, personal values, and comeback stories.",
          "evidence": [
            {
              "source_name": "SocialPilot",
              "source_type": "trend_report",
              "published_or_updated_date": "2026-07-27",
              "url": "https://www.socialpilot.co/blog/instagram-reels-trends",
              "supports": "Records Freakin’ Out in the June archive as the audio for a remember-who-you-are identity montage."
            },
            {
              "source_name": "Instagram",
              "source_type": "instagram_audio_page",
              "published_or_updated_date": null,
              "url": "https://www.instagram.com/reels/audio/1392969992841787/",
              "supports": "Direct Instagram audio page for the recording referenced by the trend report."
            }
          ]
        },
        {
          "rank": 5,
          "audio_name": "Ignoring Calls",
          "artist_name": "thehairgrowthguru_",
          "audio_type": "original_audio",
          "relevance_score": 86,
          "trend_confidence_score": 80,
          "best_for": [
            "focus-mode and productivity routines",
            "discipline and distraction-free work Reels"
          ],
          "why_selected": "This creator audio was specifically associated with focus-mode and productivity content. That makes it directly useful for discipline, deep-work, study, business-building, and avoiding-distraction motivational Reels.",
          "evidence": [
            {
              "source_name": "SocialPilot",
              "source_type": "trend_report",
              "published_or_updated_date": "2026-07-27",
              "url": "https://www.socialpilot.co/blog/instagram-reels-trends",
              "supports": "Lists Ignoring Calls by thehairgrowthguru_ in the June archive for focus-mode and productivity content."
            },
            {
              "source_name": "Instagram",
              "source_type": "instagram_audio_page",
              "published_or_updated_date": null,
              "url": "https://www.instagram.com/reels/audio/34291922853755802/",
              "supports": "Direct Instagram page for the creator-uploaded original audio."
            }
          ]
        },
        {
          "rank": 6,
          "audio_name": "PRESSURE!",
          "artist_name": "Nyck Caution",
          "audio_type": "song",
          "relevance_score": 85,
          "trend_confidence_score": 78,
          "best_for": [
            "fitness personal-record attempts",
            "high-pressure training and competition edits"
          ],
          "why_selected": "The July archive identifies this audio with sports hype, game-day countdowns, and fitness personal records. Its intensity suits pushing limits, preparation, competition, and performance-focused motivation.",
          "evidence": [
            {
              "source_name": "SocialPilot",
              "source_type": "trend_report",
              "published_or_updated_date": "2026-07-27",
              "url": "https://www.socialpilot.co/blog/instagram-reels-trends",
              "supports": "Associates PRESSURE! with sports hype, game-day countdowns, and fitness personal-record clips in July 2026."
            },
            {
              "source_name": "Instagram",
              "source_type": "instagram_audio_page",
              "published_or_updated_date": null,
              "url": "https://www.instagram.com/reels/audio/377868818218171/nyck-caution-pressure/",
              "supports": "Direct Instagram audio page identifying the track and artist."
            }
          ]
        },
        {
          "rank": 7,
          "audio_name": "Game Time",
          "artist_name": "Future & Tyla",
          "audio_type": "song",
          "relevance_score": 81,
          "trend_confidence_score": 77,
          "best_for": [
            "gym and athletic training montages",
            "competition-day and performance motivation"
          ],
          "why_selected": "Documented during June as a World Cup-related trend used for sports hype and gym montages. It is suitable for energetic workout edits, competition preparation, team motivation, and achievement sequences.",
          "evidence": [
            {
              "source_name": "SocialPilot",
              "source_type": "trend_report",
              "published_or_updated_date": "2026-07-27",
              "url": "https://www.socialpilot.co/blog/instagram-reels-trends",
              "supports": "Lists Game Time in the June archive for sports hype, gym, and travel montages."
            },
            {
              "source_name": "Instagram",
              "source_type": "instagram_audio_page",
              "published_or_updated_date": null,
              "url": "https://www.instagram.com/reels/audio/1467234368070031/",
              "supports": "Direct Instagram audio page linked for Game Time."
            },
            {
              "source_name": "Buffer",
              "source_type": "article",
              "published_or_updated_date": "2026-06-30",
              "url": "https://buffer.com/resources/trending-audio-instagram/",
              "supports": "Identifies Game Time as trending on Instagram and notes use in sports edits and gym content."
            }
          ]
        },
        {
          "rank": 8,
          "audio_name": "DNA (More Than a Game)",
          "artist_name": "Andrea Bocelli, David Guetta, Megan Thee Stallion & EJAE",
          "audio_type": "song",
          "relevance_score": 78,
          "trend_confidence_score": 74,
          "best_for": [
            "purpose and personal-mission storytelling",
            "team identity and legacy montages"
          ],
          "why_selected": "The June trend archive links this anthem to identity and purpose storytelling. It fits motivational narratives about personal mission, belonging, teamwork, values, legacy, and striving for something larger than oneself.",
          "evidence": [
            {
              "source_name": "SocialPilot",
              "source_type": "trend_report",
              "published_or_updated_date": "2026-07-27",
              "url": "https://www.socialpilot.co/blog/instagram-reels-trends",
              "supports": "Lists DNA (More Than a Game) in the June archive for brand identity and purpose storytelling."
            },
            {
              "source_name": "Instagram",
              "source_type": "instagram_audio_page",
              "published_or_updated_date": null,
              "url": "https://www.instagram.com/reels/audio/2232168290889562/",
              "supports": "Direct Instagram audio page for the recording cited in the archive."
            }
          ]
        },
        {
          "rank": 9,
          "audio_name": "Respect",
          "artist_name": "Aretha Franklin",
          "audio_type": "song",
          "relevance_score": 73,
          "trend_confidence_score": 72,
          "best_for": [
            "confidence and self-worth statements",
            "business, skill, or transformation flexes"
          ],
          "why_selected": "The July trend format centers on confidently showing what a creator or business can deliver. Although broader than motivation, it works for assertive self-worth messages, success reveals, capability demonstrations, and confidence-building edits.",
          "evidence": [
            {
              "source_name": "SocialPilot",
              "source_type": "trend_report",
              "published_or_updated_date": "2026-07-27",
              "url": "https://www.socialpilot.co/blog/instagram-reels-trends",
              "supports": "Lists Respect in July for confident product or service flex content using the recognizable lyric format."
            },
            {
              "source_name": "Instagram",
              "source_type": "instagram_audio_page",
              "published_or_updated_date": null,
              "url": "https://www.instagram.com/reels/audio/515371218997711/",
              "supports": "Direct Instagram audio page linked for the Aretha Franklin recording."
            }
          ]
        },
        {
          "rank": 10,
          "audio_name": "SPEND DAT SAX",
          "artist_name": "Corey Staggers",
          "audio_type": "instrumental",
          "relevance_score": 70,
          "trend_confidence_score": 70,
          "best_for": [
            "process-to-result transformation videos",
            "skill-building and completed-project reveals"
          ],
          "why_selected": "The June archive associates this audio with process-to-result Reels. That format adapts well to motivational transformations showing practice, discipline, consistent work, and the final outcome.",
          "evidence": [
            {
              "source_name": "SocialPilot",
              "source_type": "trend_report",
              "published_or_updated_date": "2026-07-27",
              "url": "https://www.socialpilot.co/blog/instagram-reels-trends",
              "supports": "Includes SPEND DAT SAX by Corey Staggers in the June archive for process-to-result brand Reels."
            },
            {
              "source_name": "Instagram",
              "source_type": "instagram_audio_page",
              "published_or_updated_date": null,
              "url": "https://www.instagram.com/reels/audio/27043767605285229/",
              "supports": "Direct Instagram audio page linked for the identified recording."
            }
          ]
        }
      ],
      "limitations": [
        "Limited availability of niche-specific trend reports for the exact research period."
      ]
    }
  },
  "debug_raw_response": null,
  "debug_validation_errors": null,
  "created_at": "2026-08-07 03:16:01",
  "updated_at": "2026-08-07 03:16:09",
  "completed_at": "2026-08-07 03:16:09",
  "failed_at": null
}