Content Gap Analysis API workflow

POST /v1/workflows/content-opportunitiesAbout Content Gap Analysis

Workflow endpoint that finds content opportunities by combining AI answers, SEO keyword demand, trends, Reddit, YouTube and citation data in one call.

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-opportunities

$0.82 · flat per call

Parameters

topicstringrequired

Market, niche, product category, or audience to research.

audiencestringoptional

Optional target audience or ICP.

brandstringoptional

Optional brand/domain to account for in the opportunity scan.

competitorsstring[]optional

Competitor brands/domains to compare against.

countrystringoptional

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

channelsenum[]optional

Optional data sources to include. Defaults to all relevant sources.

Values:ai_searchseo_keywordsgoogle_trendsreddityoutube

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	Market, niche, product category, or audience to research.
audienceoptional	string	Optional target audience or ICP.
brandoptional	string	Optional brand/domain to account for in the opportunity scan.
competitorsoptional	string[]	Competitor brands/domains to compare against.
countryoptional	string	ISO-2 country code for localized SEO keyword data. Default: "us".
channelsoptional	enum[]	Optional data sources to include. Defaults to all relevant sources. Values:ai_searchseo_keywordsgoogle_trendsreddityoutube
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-opportunities \
  -X POST \
  -H "Authorization: Bearer $CITE42_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"topic":"AI-powered CRM","competitors":["Rival CRM","Legacy CRM"]}'

Response

{
  "status": "workflow_result",
  "workflow": "find_content_opportunities",
  "summary": "Find content opportunities using demand and visibility signals.",
  "input": {
    "topic": "AI-powered CRM",
    "competitors": [
      "Rival CRM",
      "Legacy CRM"
    ]
  },
  "results": [
    {
      "endpoint": "/v1/keywords",
      "tool": "cite42_keywords",
      "why": "Add SEO keyword demand and related ideas.",
      "data": {
        "requestedKeyword": "AI-powered CRM",
        "keyword": "AI-powered CRM",
        "status": "exact",
        "volume": 4400,
        "cpc": 3.12,
        "competition": 0.41,
        "competitionLevel": "MEDIUM",
        "ideas": [
          {
            "keyword": "AI CRM for startups",
            "volume": 8100,
            "cpc": 2.84,
            "competition": 0.38,
            "competitionLevel": "MEDIUM"
          }
        ]
      },
      "ok": true
    }
  ],
  "suggestedPrompt": "Prioritize opportunities with demand and weak existing AI answers."
}