Competitor Content Analysis API workflow

POST /v1/workflows/competitor-contentAbout Competitor Content Analysis

Workflow endpoint that finds competitor content gaps from AI rankings, AI citations and SEO keyword demand, with each source result labelled.

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/competitor-content

$0.72 · flat per call

Parameters

competitorsstring[]required
Competitor brands, domains, or channels to analyze.
topicstringoptional
Optional topic/category to constrain the analysis.
brandstringoptional
Optional primary brand/domain to compare against competitors.
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.

Request

curl https://www.cite42.dev/api/v1/workflows/competitor-content \
  -X POST \
  -H "Authorization: Bearer $CITE42_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"competitors":["Rival CRM","Legacy CRM"],"topic":"best startup CRM"}'

Response

{
  "status": "workflow_result",
  "workflow": "analyze_competitor_content",
  "summary": "Find competitor content gaps across AI rankings, citations, and SEO demand.",
  "input": {
    "competitors": [
      "Rival CRM",
      "Legacy CRM"
    ],
    "topic": "best startup CRM"
  },
  "results": [
    {
      "endpoint": "/v1/rankings",
      "tool": "cite42_rankings",
      "why": "Measure competitor visibility in AI answers.",
      "data": {
        "query": "best startup CRM",
        "rankings": [
          {
            "competitor": "Rival CRM",
            "mentionRate": 0.8,
            "avgPosition": 1.5,
            "byModel": {
              "chatgpt": 1,
              "claude": 1,
              "perplexity": 2,
              "gemini": 2,
              "google_ai_overview": null
            }
          }
        ],
        "measurement": {
          "methodologyVersion": "2026-09-28-v1:aio-v2",
          "surfaces": [
            {
              "model": "chatgpt",
              "provider": "OpenAI",
              "access": "official-api",
              "webSearch": "auto",
              "status": "complete"
            },
            {
              "model": "claude",
              "provider": "Anthropic",
              "access": "official-api",
              "webSearch": "auto",
              "status": "complete"
            },
            {
              "model": "perplexity",
              "provider": "Perplexity",
              "access": "native-search",
              "webSearch": "always",
              "status": "complete"
            },
            {
              "model": "gemini",
              "provider": "Google Gemini",
              "access": "official-api",
              "webSearch": "auto",
              "status": "complete"
            },
            {
              "model": "google_ai_overview",
              "provider": "Google AI Overviews",
              "access": "live-serp",
              "webSearch": "always",
              "status": "complete"
            }
          ]
        }
      },
      "ok": true
    }
  ],
  "suggestedPrompt": "Show where our content can outrank or out-cite these competitors."
}