AI Citations API: Domains and Pages Cited by AI | Genezio

The citations routes of the Genezio API give the pages that answer engines cite when they speak of your topics. An answer engine gives the pages that it read as the sources of its answer. These routes read those pages.

Route	Gives
`GET /customer/v1/brands/{brand_id}/reports/citations`	The occurrences period by period, and the share of each kind of owner.
`GET /customer/v1/brands/{brand_id}/citations/domains`	The domains, the most frequent first.
`GET /customer/v1/brands/{brand_id}/citations/domains/{domain}`	One domain: over time, by topic, by scenario and by engine.
`GET /customer/v1/brands/{brand_id}/citations/urls`	The pages, the most frequent or the newest first.

Two counts of citations

Count	Meaning
`occurrences`	The answers that list the page as a source.
`cited_occurrences`	The answers whose text also quotes the page. A page can be a source and not be in the text.

The citations report

curl "https://app.backend.genezio.ai/customer/v1/brands/12/reports/citations?granularity=week&domains=g2.com&domains=reddit.com" \
  -H "X-API-Key: $GENEZIO_API_KEY"

Each row with "domain": null counts each domain together.
Each domain of domains gets its own series.
info.summary.by_ownership gives the share of each kind of owner of the pages, such as first_party (your pages), competitor_owned and third_party_editorial.

Filters of the citations routes

Each route of the citations takes these filters:

Parameter	Meaning
`start_date`, `end_date`	The range. See Date ranges.
`models`, `topic_ids`	The engines and the topics.
`ownership`	Who owns the page: `first_party`, `competitor_owned`, `third_party_editorial`, `industry_trade_publication`, `government_regulatory`, `academic_research`, `aggregator_marketplace`, `social_ugc_platform`, `other`.
`content_types`	What the page is, such as `review_editorial`, `listicle_best_of`, `comparison_vs_page`, `forum_thread_qa`.
`sentiment`	`positive`, `neutral` or `negative`: how the page speaks of your brand.
`first_party`	`true` for your pages only, `false` for the pages of others.

Find the pages that work against you: citations/urls?sentiment=negative&first_party=false&sort=occurrences.