Search public YouTube videos, Shorts, and live streams by keyword and return normalized video, channel, engagement, and source data.
Endpoint
- Path:
/api/v1/youtube/search - Cost: 1 credit per successful request
Query parameters
| Name | Required | Description | Example |
|---|---|---|---|
query | Yes | The keyword or phrase to search for. | social listening |
raw | No | Include the unchanged provider response in the raw field. Defaults to false. | true |
curl --get 'https://api.sociallisteningapi.com/api/v1/youtube/search' \
--data-urlencode 'query=social listening' \
--data-urlencode 'raw=true' \
--header 'x-api-key: YOUR_API_KEY'Responses
{
"success": true,
"platform": "youtube",
"endpoint": "/api/v1/youtube/search",
"data": {
"items": [
{
"id": "BzSzwqb-OEE",
"platform": "youtube",
"url": "https://www.youtube.com/watch?v=BzSzwqb-OEE",
"content": {
"title": "How to use social listening",
"text": null,
"media_urls": [],
"thumbnail_url": "https://i.ytimg.com/vi/BzSzwqb-OEE/hq720.jpg"
},
"author": {
"id": "UCoRR6OLuIZ2-5VxtnQIaN2w",
"username": "sociallistening",
"display_name": "Social Listening",
"avatar_url": "https://yt3.ggpht.com/example=s88-c-k-c0x00ffffff-no-rj",
"verified": null
},
"engagement": {
"views": 14860541,
"likes": null,
"comments": null,
"shares": null,
"saves": null
},
"published_at": "2026-08-05T01:30:00.000Z",
"ext": {
"content_type": "video",
"duration_seconds": 254,
"duration_text": "4:14",
"published_time_text": "1 day ago",
"badges": [
"4K"
]
}
}
]
},
"pagination": {
"next_cursor": null,
"has_more": false,
"page_size": 1
},
"raw": {
"videos": [],
"channels": [],
"playlists": [],
"shorts": [],
"shelves": [],
"lives": [],
"continuationToken": null
},
"request_id": "req_example123",
"credits_used": 1,
"credits_remaining": 99
}