REST APIExternal Service

AI Citations Report API

Generate a client-facing GEO AI Citations Report for a domain: which AI-search prompts cite the site across Google AI Overview and ChatGPT, the retrieved-but-not-cited gap, organic-traffic context, and per-article citation coverage. Returns a PDF.

Endpoint

Data comes from DataForSEO LLM Mentions (cited vs. retrieved), Domain Rank Overview, and Historical Rank Overview. Rate limited to 20 requests/hour.

POST https://www.enception.ai/api/external/ai-citations

Authentication

Send your API key in the X-API-Key header.

Get an API key (self-serve): Sign up or log in, then generate a free-tier key under Account → API Key. The free tier includes 10 AI Citations reports per month; contact the Enception team for higher limits.

Request body

domain — required. The domain to report on (e.g. trustauto.ca).
brandName — optional. Display name in the report title. Defaults to the domain.
locationCode — optional. DataForSEO location code (2840 = US, 2124 = Canada, 2826 = UK). Defaults to 2840.
languageCode — optional. Defaults to en.
articles — optional. Array of /articles/ slugs or URLs for the content-coverage section.
genDate — optional. Report date (YYYY-MM-DD). Defaults to today.
format — optional. pdf (default), html, or json.

Example

curl -X POST https://www.enception.ai/api/external/ai-citations \
  -H 'Content-Type: application/json' \
  -H "X-API-Key: $ENCEPTION_API_KEY" \
  -d '{"domain":"trustauto.ca","brandName":"TrustAuto.ca","locationCode":2124}' \
  -o trustauto-ai-citations.pdf

The PDF response also carries X-Cited-Count andX-Retrieved-Count headers.