AI Citation Gaps API workflow

POST /v1/workflows/ai-citation-gapsAbout AI Citation Gaps

Workflow endpoint that finds queries where AI models answer your category but cite competitors or third-party sources instead of your brand.

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/ai-citation-gaps

$0.80 · flat per call

Parameters

querystringrequired

AI-search query to inspect for citation gaps.

brandstringrequired

Brand or domain that should earn citations.

urlstringoptional

Optional exact URL to check for citations.

competitorsstring[]optional

Competitor brands/domains to compare against.

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
queryrequired	string	AI-search query to inspect for citation gaps.
brandrequired	string	Brand or domain that should earn citations.
urloptional	string	Optional exact URL to check for citations.
competitorsoptional	string[]	Competitor brands/domains to compare against.
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/ai-citation-gaps \
  -X POST \
  -H "Authorization: Bearer $CITE42_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"best startup CRM","brand":"Acme CRM","competitors":["Rival CRM","Legacy CRM"]}'

Response

{
  "status": "workflow_result",
  "workflow": "find_ai_citation_gaps",
  "summary": "Find sources AI models cite instead of the selected brand.",
  "input": {
    "query": "best startup CRM",
    "brand": "Acme CRM",
    "competitors": [
      "Rival CRM",
      "Legacy CRM"
    ]
  },
  "results": [
    {
      "endpoint": "/v1/citations",
      "tool": "cite42_citations",
      "why": "Identify the sources currently earning citations.",
      "data": {
        "query": "best startup CRM",
        "sources": [
          {
            "url": "https://reviews.example/startup-crm",
            "title": "Startup CRM guide",
            "citedBy": [
              "chatgpt",
              "perplexity"
            ],
            "count": 2
          }
        ],
        "lookup": {
          "url": "https://acme.example/guides/startup-crm",
          "cited": true,
          "citedBy": [
            "chatgpt"
          ]
        },
        "measurement": {
          "methodologyVersion": "2026-09-28-v1",
          "surfaces": [
            {
              "model": "chatgpt",
              "provider": "OpenAI",
              "access": "official-api",
              "webSearch": "auto",
              "status": "complete"
            },
            {
              "model": "perplexity",
              "provider": "Perplexity",
              "access": "native-search",
              "webSearch": "always",
              "status": "complete"
            }
          ]
        }
      },
      "ok": true
    }
  ],
  "suggestedPrompt": "Explain the citation gaps and recommend content to close them."
}