Get cited-source analytics and citation events
Authorizations
Organization-scoped API key. Available scopes:
- content:read: Read site pages, markdown content, and llms.txt files
- content:write: Create, update, and delete site pages and content
- prompts:read: Read prompts, topics, and prompt analysis results
- prompts:write: Create, update, archive prompts
- simulations:read: Read agent-simulation tasks, runs, environments, and analytics
- simulations:write: Create and trigger simulation runs
- logs:read: Read AI-traffic logs and request-level audit events
- analytics:read: Read analytics aggregates (rankings, mentions, sources, SOV)
- analytics:write: Write events to analytics
- products:read: Read product metadata and competitor data
- products:write: Update product settings and competitor lists
Query Parameters
Product ID scope. Repeat to include multiple products. Prefer this over simulationBrandIds.
1Deprecated. Use productId. Existing cited-source callers may pass this repeated product ID parameter.
1x >= 11 <= x <= 1000x >= 11 <= x <= 100011Filter by per-brand ownership of the source. Independent of category (content type). Requires the per-brand ownership sync in Tinybird (DEV-2310).
self, competitor, other 11111When regionId is set, include citation rows whose region is unset.
Include row-level citation events. Defaults to false for performance. Only needed for detailed event analysis.
Filter to sources where the product was mentioned or not mentioned. Sources without mention analysis are excluded from both.
mentioned, not_mentioned ^\d{4}-\d{2}-\d{2}$^\d{4}-\d{2}-\d{2}$citation_count, unique_conversations asc, desc