How it works
Doesn't cost a generation credit (tracked as research). Lets the agent surface 10 different angles to the user, who can pick the ones they want to turn into full concepts in a second call.
Inputs
Name
Type
Required
Description
research
string
required
Research blob from research_url or your own context.
mode
'ads' | 'social'
optional
Default ads.
customInstruction
string
optional
Steer the directions.
brandId
string
optional
Brand context for the seeds.
profileId
string
optional
Profile context for visual constraints.
Returns
{ ideas: [{ title, description }], count: number }Examples
Two-phase generation: ideas, then concepts
Agent gets 10 ideas, asks user to pick favorites, then calls generate_concepts_from_research with selectedIdeas.
{
"research": "<research blob>",
"brandId": "ectL5JsJKz55ItiFzEkB",
"profileId": "profile-1777862636833-ijz8fe"
}Related tools
generate_concepts_from_researchGenerate ad concepts from existing research
Skip the research step — pass research text directly. Useful when you've already called research_url or have your own context.
research_urlResearch a URL with Perplexity
Run Perplexity sonar research on any URL — extracts business name, location, services, USPs, audience, hooks.