Inspiration tools reference

​

search_inspiration

Use search_inspiration when you want to retrieve ad examples from the inspiration library. It searches the full public ad catalog — millions of live and historical ads — not a curated subset.

​

Common inputs

• query — keyword across brand, headline, and ad copy
• platform — e.g. facebook, instagram
• category — niche filter, e.g. beauty, health/wellness
• type — video, image, carousel, dpa, or dco
• liveOnly — only currently running ads
• limit — up to 25 results (default 10)

​

Common output fields

• id — the ad ID to pass to generate_brief
• brandName
• headline
• description
• categories
• niches
• platform
• type
• displayFormat
• live
• thumbnail
• videoUrl

​

Best next step

Once you have a good ad id, move directly to generate_brief.

​

generate_brief

Use generate_brief when you want to turn a strong inspiration ad into a brand-tailored creative brief. It draws on the source ad’s full transcription and emotional drivers, so the brief reflects why the original ad worked.

​

Inputs

• brandId — the brand to tailor the brief toward
• postId — the ad id returned by search_inspiration

​

Common output fields

• concept
• hook
• keyMessage
• cta
• visualDirection
• tone
• format
• aspectRatio
• targetAudience
• scriptOrCopy
• whyItWorks

​

Best workflow

1. search_inspiration
2. pick the best ad — note its id
3. generate_brief (pass the id as postId)
4. ask the model to create variations of the brief