curl -X POST https://api.tryprofound.com/v2/reports/social/youtube/videos \
-H "X-API-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"category_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"start_date": "2026-06-01",
"end_date": "2026-06-30",
"filter": {
"field": "channel",
"op": "in",
"value": ["examplechannel"]
},
"attribution": "attributed",
"limit": 10
}'
{
"info": {
"category_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"total_results": 1,
"count": 1,
"next_cursor": null,
"limit": 10,
"attribution": "attributed",
"models": ["ChatGPT", "Google Gemini"],
"start_date": "2026-06-01",
"end_date": "2026-06-30",
"filter": {
"field": "channel",
"op": "in",
"value": ["examplechannel"]
},
"source_types": ["video", "short"]
},
"data": [
{
"video_id": "dQw4w9WgXcQ",
"source_type": "video",
"title": "Example Video",
"channel_title": "Example Channel",
"channel_handle": "examplechannel",
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"channel_url": "https://www.youtube.com/@examplechannel",
"rank": 1,
"published_at": "2026-06-12",
"duration_seconds": 245,
"video_category": "Education",
"count": 73,
"citation_share": 0.21
}
]
}
YouTube
Videos
Rank cited YouTube videos, for one channel or across all of them.
POST
/
v2
/
reports
/
social
/
youtube
/
videos
curl -X POST https://api.tryprofound.com/v2/reports/social/youtube/videos \
-H "X-API-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"category_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"start_date": "2026-06-01",
"end_date": "2026-06-30",
"filter": {
"field": "channel",
"op": "in",
"value": ["examplechannel"]
},
"attribution": "attributed",
"limit": 10
}'
{
"info": {
"category_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"total_results": 1,
"count": 1,
"next_cursor": null,
"limit": 10,
"attribution": "attributed",
"models": ["ChatGPT", "Google Gemini"],
"start_date": "2026-06-01",
"end_date": "2026-06-30",
"filter": {
"field": "channel",
"op": "in",
"value": ["examplechannel"]
},
"source_types": ["video", "short"]
},
"data": [
{
"video_id": "dQw4w9WgXcQ",
"source_type": "video",
"title": "Example Video",
"channel_title": "Example Channel",
"channel_handle": "examplechannel",
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"channel_url": "https://www.youtube.com/@examplechannel",
"rank": 1,
"published_at": "2026-06-12",
"duration_seconds": 245,
"video_category": "Education",
"count": 73,
"citation_share": 0.21
}
]
}
Clasifica los videos de YouTube citados, para un canal o para todos. Se calcula
a partir de los datos de citas de Profound, no de YouTube Analytics.
- Tipos de fuente:
video,short,channel,playlistuother.otherestá disponible conunattributedoall; con el modo predeterminadoattributed, se rechazan las solicitudes que contienenother. Omitesource_typespara devolvervideoyshortcon el modo predeterminadoattributed;unattributedyallamplían el valor predeterminado a los cinco tipos de fuente. Proporciona una lista no vacía; los valores duplicados se eliminan. - Atribución:
attributed(el valor predeterminado),unattributedoall. Una fila sin atribuir no tiene canal:source_typeesotherpara una URL de búsqueda o de feed que no nombra ninguna fuente, y cualquier otro tipo es una fuente para la que no tenemos canal. - Agrupación y series temporales: No se admiten.
/videosno aceptagroup_byniinterval; los campos desconocidos se rechazan. - Paginación:
limittiene un valor predeterminado de 10 y acepta de 1 a 50. Devuelve el valor opacoinfo.next_cursorcomocursorde la solicitud para obtener la página siguiente;inforepite tucursoren las páginas posteriores a la primera. Elinfode la respuesta repitecategory_id, ellimitefectivo yattribution. - Filtros: Los campos a nivel de prompt son
model,topic,region,prompt,persona,tagyanalysis_type. El filtrochannelaceptais,in,contains,not_contains,contains_case_insensitiveynot_contains_case_insensitive:is/inseleccionan identificadores exactos, mientras que los demás operadores buscan coincidencias en los títulos o identificadores de los canales.domainypagese rechazan. Una hojachannelno puede compartir unorni unnotcon una hoja a nivel de prompt; coloca las capas por separado en cláusulasand.
Los informes v2 comparten una forma de solicitud y un árbol de filtros. Consulta
Filtrado y conceptos para ver los
operadores de filtro, los rangos de fechas, la paginación y la profundidad de
los filtros. Las indicaciones sobre agrupación y series temporales no se
aplican a este endpoint.
curl -X POST https://api.tryprofound.com/v2/reports/social/youtube/videos \
-H "X-API-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"category_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"start_date": "2026-06-01",
"end_date": "2026-06-30",
"filter": {
"field": "channel",
"op": "in",
"value": ["examplechannel"]
},
"attribution": "attributed",
"limit": 10
}'
{
"info": {
"category_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"total_results": 1,
"count": 1,
"next_cursor": null,
"limit": 10,
"attribution": "attributed",
"models": ["ChatGPT", "Google Gemini"],
"start_date": "2026-06-01",
"end_date": "2026-06-30",
"filter": {
"field": "channel",
"op": "in",
"value": ["examplechannel"]
},
"source_types": ["video", "short"]
},
"data": [
{
"video_id": "dQw4w9WgXcQ",
"source_type": "video",
"title": "Example Video",
"channel_title": "Example Channel",
"channel_handle": "examplechannel",
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"channel_url": "https://www.youtube.com/@examplechannel",
"rank": 1,
"published_at": "2026-06-12",
"duration_seconds": 245,
"video_category": "Education",
"count": 73,
"citation_share": 0.21
}
]
}
Autorizaciones
APIKeyHeaderBearerAuth
Cuerpo
application/json
Cited videos, optionally narrowed to specific channels.
YYYY-MM-DD, ET, inclusive
YYYY-MM-DD, ET, inclusive
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.
Show child attributes
Show child attributes
Page size; default 10, max 50.
Rango requerido:
0 < x <= 50Limit results to YouTube source types: video, short, channel, playlist, or other. Omit to include video and short with the default attribution='attributed'; unattributed and all widen the default to all five source types. Requests containing other with attribution='attributed' are rejected.
Opciones disponibles:
video, short, channel, playlist, other Choose attributed citations, unattributed citations, or all citations. An unattributed row has no channel: source_type is other for a search or feed URL that names no source, and any other type is a source we have no channel for.
Opciones disponibles:
attributed, unattributed, all ¿Esta página le ayudó?