How it works
One-shot. Costs one generation credit. Auto-saves to your generation history (visible in /dashboard/history and via list_generations). Use generate_concepts_from_research instead if you want to inspect/modify research first.
Inputs
Name
Type
Required
Description
url
string
required
Website URL to research and generate from.
profileId
string
optional
Profile to apply. Defaults to active.
brandId
string
optional
Brand context woven into prompts.
count
integer (1–10)
optional
How many concepts to produce. Default 5.
mode
'ads' | 'social'
optional
Output mode.
customInstruction
string
optional
Steer the generation.
includeHeadlineCopy
boolean
optional
Include headline + body. Default true.
includeHashtags
boolean
optional
Include hashtags. Default true.
Returns
{ concepts: Concept[], generationId, mode }Examples
Cold-start concept generation for a new client
Agent doesn't need to inspect research — just generate from URL with the active profile.
{
"url": "https://sellwithcrump.com",
"count": 5,
"brandId": "ectL5JsJKz55ItiFzEkB"
}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.