Content Brief API workflow

POST /v1/workflows/content-briefAbout Content Brief

Workflow endpoint that generates a data-backed content brief from AI answers, cited sources, keyword demand and the questions people ask.

Overview

Workflow tools 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.82 · flat per call

Parameters

topicstringrequired

Topic, keyword, or content idea to brief.

audiencestringoptional

Optional target audience or ICP.

brandstringoptional

Optional brand/domain the brief is for.

goalstringoptional

Optional content goal, e.g. rank, earn citations, convert, educate.

countrystringoptional

ISO-2 country code for localized SEO keyword data. Default: "us".

modelsenum[]optional

AI surfaces to query, each billed separately; pass a subset when the user names surfaces or wants a lower cost. Omit for the defaults (chatgpt, perplexity, gemini); fullSweep queries all five. google_ai_overview accepts queries up to 700 characters, the others 2000.

Values:chatgptclaudeperplexitygeminigoogle_ai_overview

fullSweepbooleanoptional

Query all five AI surfaces (adds claude and google_ai_overview) for full cross-surface coverage, at a higher cost. Ignored when models is given.

Parameter	Type	Description
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	enum[]	AI surfaces to query, each billed separately; pass a subset when the user names surfaces or wants a lower cost. Omit for the defaults (chatgpt, perplexity, gemini); fullSweep queries all five. google_ai_overview accepts queries up to 700 characters, the others 2000. Values:chatgptclaudeperplexitygeminigoogle_ai_overview
fullSweepoptional	boolean	Query all five AI surfaces (adds claude and google_ai_overview) for full cross-surface coverage, at a higher cost. Ignored when models is given.

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":"AI-powered CRM","audience":"startup teams"}'

Response

{
  "status": "workflow_result",
  "workflow": "generate_content_brief",
  "summary": "Generate a data-backed content brief from market signals.",
  "input": {
    "topic": "AI-powered CRM",
    "audience": "startup teams"
  },
  "results": [
    {
      "endpoint": "/v1/youtube/trends",
      "tool": "cite42_youtube_trends",
      "why": "Add current creator angles and useful formats.",
      "data": {
        "topic": "AI-powered CRM",
        "region": "US",
        "timeframe": "past_30_days",
        "provider": "youtube_data_api",
        "publishedAfter": "2026-06-20T12:00:00.000Z",
        "risingVideos": [
          {
            "videoId": "example123",
            "title": "Best AI CRM 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 CRM 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 CRM tools tested"
            ]
          }
        ],
        "creatorAngles": [
          {
            "angle": "Review/test",
            "why": "Review framing suggests trust-building and proof are important in this topic.",
            "examples": [
              "Best AI CRM 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."
}