Find AI Citation Gaps

Workflow contract for finding queries where AI cites other sources instead of your brand.

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

$0.88 · flat per call

Parameters

`query`required	string	AI-search query to inspect for citation gaps.
`brand`required	string	Brand or domain that should earn citations.
`url`optional	string	Optional exact URL to check for citations.
`competitors`optional	string[]	Competitor brands/domains to compare against.
`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/ai-citation-gaps \
  -X POST \
  -H "Authorization: Bearer $CITE42_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"best tools for AI search visibility","brand":"Cite42","competitors":["Peec AI","Profound"]}'

Response

{
  "status": "workflow_result",
  "workflow": "find_ai_citation_gaps",
  "summary": "Find sources AI models cite instead of the selected brand.",
  "input": {
    "query": "best tools for AI search visibility",
    "brand": "Cite42",
    "competitors": [
      "Peec AI",
      "Profound"
    ]
  },
  "results": [
    {
      "endpoint": "/v1/citations",
      "tool": "cite42_citations",
      "why": "Identify the sources currently earning citations.",
      "data": {
        "query": "how to optimize for AI search",
        "sources": [
          {
            "url": "https://example.com/ai-search-guide",
            "title": "AI search optimization guide",
            "citedBy": [
              "chatgpt",
              "perplexity"
            ],
            "count": 2
          }
        ],
        "lookup": {
          "url": "yourbrand.com/blog/aeo",
          "cited": true,
          "citedBy": [
            "chatgpt"
          ]
        }
      },
      "ok": true
    }
  ],
  "suggestedPrompt": "Explain the citation gaps and recommend content to close them."
}