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

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' \
  -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.