Citations And Sources Resources

Use citations for URLs that appeared in answers. Use sources for search results or source records associated with runs.

Citations

Endpoint:

GET /api/v1/citations

Filters: run_id, domain.

Key fields include url, canonical_url, canonical_domain, etld_plus_one, title, source_type, direct, segment_text, and citation_order.

Sources

Endpoint:

GET /api/v1/sources

Filters: run_id, domain, used_in_answer.

Key fields include url, canonical_url, canonical_domain, title, snippet, source_type, rank, and used_in_answer.

Domain filtering

Use domain with canonical domains, for example:

GET /api/v1/citations?domain=example.com

Window scoping

Citations and sources are run-scoped resources. To export citations or sources for a measurement window, first call /api/v1/runs?measurement_window_id=..., then request citations or sources with the relevant run_id values.