Generate Content Brief
Workflow contract for generating a data-backed content brief from Cite42 primitives.
Overview
Workflow endpoints run their primitives in parallel and return each primitive's full output, labeled per source. Pricing is calculated from the primitives that ran successfully plus the selected model rates: failed or skipped steps are not charged.
Reference
POST
/v1/workflows/content-brief$0.78 · flat per call
Parameters
topicrequired | string | Topic, keyword, or content idea to brief. |
audienceoptional | string | Optional target audience or ICP. |
brandoptional | string | Optional brand/domain the brief is for. |
goaloptional | string | Optional content goal, e.g. rank, earn citations, convert, educate. |
countryoptional | string | ISO-2 country code for localized SEO keyword data. Default: "us". |
modelsoptional | array of enum (chatgpt | claude | perplexity | gemini | google_ai_overview) | Optional model subset. Omit to query all five AI surfaces (chatgpt, claude, perplexity, gemini, google_ai_overview). Pass ["perplexity"] or ["perplexity","claude"] when the user asks for specific surfaces or wants to reduce cost. |
Request
curl https://www.cite42.dev/api/v1/workflows/content-brief \
-X POST \
-H "Authorization: Bearer $CITE42_API_KEY" \
-H "Content-Type: application/json" \
-d '{"topic":"how to optimize content for AI citations","audience":"SEO agencies"}'Response
{
"status": "workflow_result",
"workflow": "generate_content_brief",
"summary": "Generate a data-backed content brief from market signals.",
"input": {
"topic": "how to optimize content for AI citations",
"audience": "SEO agencies"
},
"results": [
{
"endpoint": "/v1/youtube/trends",
"tool": "cite42_youtube_trends",
"why": "Add current creator angles and useful formats.",
"data": {
"topic": "AI tools for video creators",
"region": "US",
"timeframe": "past_30_days",
"provider": "youtube_data_api",
"publishedAfter": "2026-06-20T12:00:00.000Z",
"risingVideos": [
{
"videoId": "example123",
"title": "Best AI video tools tested",
"channelTitle": "Creator Lab",
"channelId": "UCexample",
"url": "https://www.youtube.com/watch?v=example123",
"publishedAt": "2026-07-10T09:00:00.000Z",
"descriptionSnippet": "A practical comparison of AI video tools.",
"thumbnailUrl": "https://i.ytimg.com/vi/example123/hqdefault.jpg",
"duration": "PT12M34S",
"viewCount": 142000,
"likeCount": 6300,
"commentCount": 410,
"viewsPerDay": 7100
}
],
"titlePatterns": [
{
"pattern": "Best/tools list",
"count": 5,
"examples": [
"Best AI video tools tested"
]
}
],
"creatorAngles": [
{
"angle": "Review/test",
"why": "Review framing suggests trust-building and proof are important in this topic.",
"examples": [
"Best AI video tools tested"
]
}
],
"channelBreakdown": [
{
"channelTitle": "Creator Lab",
"videos": 2,
"totalViews": 215000,
"totalComments": 680
}
],
"formatIdeas": [
"Publish a ranked tools video with clear use-case segments."
],
"sourceUrls": [
"https://www.youtube.com/watch?v=example123"
],
"fetchedAt": "2026-07-20T12:00:00.000Z"
},
"ok": true
}
],
"suggestedPrompt": "Create the brief with target keywords, sources, questions, and angle."
}