Analyze Competitor Content

Workflow contract for competitor content gaps across AI rankings, citations, and SEO demand.

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

$0.85 · flat per call

Parameters

`competitors`required	string[]	Competitor brands, domains, or channels to analyze.
`topic`optional	string	Optional topic/category to constrain the analysis.
`brand`optional	string	Optional primary brand/domain to compare against competitors.
`country`optional	string	ISO-2 country code for localized SEO keyword data. Default: `"us"`.
`models`optional	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/competitor-content \
  -X POST \
  -H "Authorization: Bearer $CITE42_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"competitors":["Peec AI","Profound"],"topic":"AI search visibility"}'

Response

{
  "status": "workflow_result",
  "workflow": "analyze_competitor_content",
  "summary": "Find competitor content gaps across AI rankings, citations, and SEO demand.",
  "input": {
    "competitors": [
      "Peec AI",
      "Profound"
    ],
    "topic": "AI search visibility"
  },
  "results": [
    {
      "endpoint": "/v1/rankings",
      "tool": "cite42_rankings",
      "why": "Measure competitor visibility in AI answers.",
      "data": {
        "query": "best CRM for SaaS",
        "rankings": [
          {
            "competitor": "hubspot",
            "mentionRate": 0.8,
            "avgPosition": 1.5,
            "byModel": {
              "chatgpt": 1,
              "claude": 1,
              "perplexity": 2,
              "gemini": 2,
              "google_ai_overview": 1
            }
          }
        ]
      },
      "ok": true
    }
  ],
  "suggestedPrompt": "Show where our content can outrank or out-cite these competitors."
}