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
}
]
}
動画
Rank cited YouTube videos, for one channel or across all of them.
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
}
]
}
- ソースタイプ:
video、short、channel、playlist、またはother。otherはunattributedまたはallで使用できます。デフォルトのattributedモードでは、otherを含むリクエストは拒否されます。デフォルトのattributedモードでsource_typesを省略するとvideoとshortが返されます。unattributedとallでは、デフォルトが 5 つすべてのソースタイプに広がります。 空でないリストを指定してください。重複する値は排除されます。 - 帰属:
attributed(デフォルト)、unattributed、またはall。 未帰属の行にはチャンネルがありません。ソースを示さない検索やフィードの URL ではsource_typeがotherになり、それ以外のタイプはチャンネルを特定できないソースです。 - グループ化と時系列: サポートされていません。
/videosはgroup_byやintervalを受け付けず、不明なフィールドは拒否されます。 - ページネーション:
limitのデフォルトは 10 で、1–50 を指定できます。不透明なinfo.next_cursorをリクエストのcursorとして渡すと次のページを取得できます。 2 ページ目以降では、infoに指定したcursorがエコーされます。レスポンスのinfoには、category_id、実際に適用されたlimit、attributionがエコーされます。 - フィルタ: プロンプトレベルのフィールドは
model、topic、region、prompt、persona、tag、analysis_typeです。channelフィルタはis、in、contains、not_contains、contains_case_insensitive、not_contains_case_insensitiveを受け付けます。is/inは完全一致のハンドルを選択し、 その他の演算子はチャンネルのタイトルまたはハンドルに一致します。domainとpageは拒否されます。channelのリーフは、プロンプトレベルのリーフと同じorやnotに含めることはできません。異なるレイヤーはand句に分けてください。
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
}
]
}
承認
ボディ
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.
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.
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.
attributed, unattributed, all このページは役に立ちましたか？