Skip to main content
POST
Clasifica los canales de YouTube citados en una categoría, o las categorías de video en las que publican. Se calcula a partir de los datos de citas de Profound, no de las analíticas de YouTube.
  • Tipos de fuente: video, short, channel, playlist u other. Omite source_types para incluir video, short, channel y playlist. Proporciona una lista no vacía; los valores duplicados se eliminan. Las agregaciones no pueden incluir other, porque esas citas no tienen canal.
  • group_by: channel (el valor predeterminado), video_category o source_type. Las tabulaciones cruzadas admitidas son ["channel", "video_category"], ["channel", "source_type"] y ["channel", "model"]. Las dimensiones duplicadas se rechazan.
  • Series temporales: Establece interval en day, week o month para devolver una fila por entidad y período. date es el inicio del intervalo en ET, por lo que un intervalo semanal o mensual puede comenzar antes de start_date. Omítelo para obtener los totales de la ventana.
  • Filas: Los campos son condicionales: date, model, source_type y video_category aparecen solo con el interval o group_by correspondiente. Con group_by: ["video_category"], la categoría se devuelve en name, no en video_category. Una categoría de video no resuelta se devuelve como "", no como null. rank es la posición del canal principal en el conjunto clasificado completo y se repite en las filas de tabulación cruzada de ese canal.
  • Paginación: limit tiene un valor predeterminado de 10 y acepta de 1 a 50. Devuelve el valor opaco info.next_cursor como cursor de la solicitud para obtener la página siguiente; info repite tu cursor en las páginas posteriores a la primera. El info de la respuesta repite category_id, el limit efectivo e interval.
  • Totales: total_results cuenta los canales distintos en la ventana, mientras que count es el número de filas devueltas; usan unidades diferentes.
  • Filtros: Los campos a nivel de prompt son model, topic, region, prompt, persona, tag y analysis_type. El filtro channel acepta is, in, contains, not_contains, contains_case_insensitive y not_contains_case_insensitive: is/in seleccionan identificadores exactos, mientras que los demás operadores buscan coincidencias en los títulos o identificadores de los canales. domain y page se rechazan. Una hoja channel no puede compartir un or ni un not con una hoja a nivel de prompt; coloca las capas separadas en cláusulas and.
En las tabulaciones cruzadas, limit cuenta los canales principales, no las filas devueltas. Por ejemplo, limit: 25 con group_by: ["channel", "video_category"] devuelve 25 canales, pero puede devolver más de 25 filas.
Los informes v2 comparten una estructura de solicitud y un árbol de filtros. Consulta Filtrado y conceptos para ver los operadores de filtro, la agrupación, los rangos de fechas, la paginación y la profundidad de los filtros.

Autorizaciones

​
X-API-Key
string
header
requerido

Cuerpo

application/json

Channel and category rollups.

​
category_id
string<uuid>
requerido
​
start_date
string
requerido

YYYY-MM-DD, ET, inclusive

​
end_date
string
requerido

YYYY-MM-DD, ET, inclusive

​
filter
FilterNode · object | null

Advanced filter tree. Prompt-level dimensions are model, topic, region, prompt, persona, tag, analysis_type. channel covers both channel cases: in with a list of handles selects exactly those channels, resolving each handle to its channel so a renamed channel is never returned in pieces; contains matches a channel's title or handle by name. Combine with and/or/not up to 3 deep. An exact channel selection must be its own and clause, and a channel leaf cannot share an or or not with a prompt-level leaf, because those compile at different stages of the query. domain and page are rejected rather than approximated: every row here is one domain, and page is not a video id.

​
limit
integer | null

Page size; default 10, max 50.

Rango requerido: 0 < x <= 50
​
cursor
string | null
​
source_types
enum<string>[] | null

Limit results to YouTube source types: video, short, channel, playlist, or other. Omit to include video, short, channel, and playlist; other is excluded because those citations have no channel. Requests containing other are rejected.

Opciones disponibles:
video,
short,
channel,
playlist,
other
​
group_by
enum<string>[]

What each row represents. Empty or ["channel"] ranks channels; ["video_category"] ranks content categories; ["source_type"] ranks source types; ["channel", "video_category"], ["channel", "source_type"] and ["channel", "model"] return cross-tabs — a row per channel per category, or per answer engine. limit counts leading channels in every case, so ten channels across nine engines is ten channels and ninety rows.

Opciones disponibles:
channel,
video_category,
model,
source_type
​
interval
enum<string> | null

Return a time series instead of window totals: one row per entity per period, each carrying date. citation_share is then relative to that period, so the series is comparable across periods. Omit for window totals.

Opciones disponibles:
day,
week,
month

Respuesta

Successful Response

​
info
YoutubeChannelsInfo · object
requerido

Channel report metadata, including effective paging and grouping settings.

​
data
YoutubeChannelRow · object[]
requerido