KPI summary for YouTube social in scope
Returns a compact KPI summary of YouTube social activity in the selected scope.
Headers
Project ID to specify the project context
Body
Start date (inclusive)
"2025-01-01"
End date (exclusive)
"2025-02-01"
Filter by country codes
Filter by language codes
Filter by AI models
Filter by query IDs
Filter by source presence: "sources" (only with sources), "no_sources" (only without), "all" (no filter). Legacy true/false values are still accepted.
all, sources, no_sources Filter by shopping presence: "shopping" (only with shopping), "no_shopping" (only without), "all" (no filter). Legacy true/false values are still accepted.
all, shopping, no_shopping Filter by query tag IDs (numeric — bigint column)
Filter by execution tag IDs
Filter by query tag group IDs — matches rows carrying any tag filed under a selected group. Combines with queryTagIds per queryTagMode.
Filter by execution tag group IDs — matches rows carrying any tag filed under a selected group. Combines with execTagIds per execTagMode.
Filter by query type. Include "untyped" to also match queries without a type. Results from since-deleted queries are excluded when this filter is set.
comparative, informative, perception, untyped Query tag matching mode: "or" matches ANY tag (default), "and" matches ALL tags.
and, or Execution tag matching mode: "or" matches ANY tag (default), "and" matches ALL tags.
and, or IANA timezone for date bucketing and filtering (e.g. "Europe/Brussels"). Defaults to UTC.
"Europe/Brussels"
Row grouping level for entity results. "none" = one row per entity, "division" = one row per division (entities not in a division get their own row), "group" = one row per top-level group (divisions roll up into their group). Defaults to "none".
none, division, group Deprecated — use groupBy instead. true is equivalent to groupBy="group".
false
Include entities that have only ever been seen in a single AI response. These are mostly one-off extraction noise and are hidden by default.
false
Response
Number of unique YouTube videos (by video_id) linked to at least one citation in scope.
42
Number of distinct AI responses in scope that cited at least one YouTube video. Same value as globalYoutubeCitations on the list endpoints.
733
Ratio citationCount / videoCount, rounded to 2 decimals. Null when videoCount = 0 (division by zero).
17.45
Number of unique YouTube channels (by channel_id) whose videos were cited in scope.
15
Number of distinct non-null countries across the latest snapshot of each cited channel. Channels with a NULL country are excluded from this count.
7