API Reference
YouTube SERP
API Reference
YouTube SERP
Retrieves organic search results from YouTube
POST
/
youtube-serp
curl --request POST \
--url https://api.growthmarketing.ai/youtube-serp \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '{
"keyword": "audi",
"language_code": "en",
"location_code": 2840,
"device": "desktop"
}'
{
"success": true,
"data": {
"data": {
"api": "serp",
"function": "live",
"se": "youtube",
"se_type": "organic",
"keyword": "audi",
"language_code": "en",
"location_code": 2840,
"device": "desktop"
},
"result": [
{
"type": "video",
"rank_group": 1,
"rank_absolute": 1,
"title": "Example Video Title",
"url": "https://www.youtube.com/watch?v=example",
"channel_title": "Channel Name",
"channel_url": "https://www.youtube.com/channel/example",
"channel_image": "https://yt3.ggpht.com/example",
"duration": "10:30",
"views": 1000000,
"uploaded_date": "2024-01-01",
"description": "Video description",
"thumbnail_url": "https://i.ytimg.com/vi/example/default.jpg",
"live": false
}
]
}
}
Authorizations
Body
application/json
Search term
Example:
"audi"
Language code
Example:
"en"
Location code (2840 for US)
Example:
2840
Device type
Available options:
desktop
, mobile
Example:
"desktop"
Response
200 - application/json
Successful response
Example:
true
Example:
"serp"
Example:
"live"
Example:
"youtube"
Example:
"organic"
Example:
"audi"
Example:
"en"
Example:
2840
Example:
"desktop"
Example:
"video"
Example:
1
Example:
1
Example:
"Example Video Title"
Example:
"https://www.youtube.com/watch?v=example"
Example:
"Channel Name"
Example:
"https://www.youtube.com/channel/example"
Example:
"https://yt3.ggpht.com/example"
Example:
"10:30"
Example:
1000000
Example:
"2024-01-01"
Example:
"Video description"
Example:
"https://i.ytimg.com/vi/example/default.jpg"
Example:
false
curl --request POST \
--url https://api.growthmarketing.ai/youtube-serp \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '{
"keyword": "audi",
"language_code": "en",
"location_code": 2840,
"device": "desktop"
}'
{
"success": true,
"data": {
"data": {
"api": "serp",
"function": "live",
"se": "youtube",
"se_type": "organic",
"keyword": "audi",
"language_code": "en",
"location_code": 2840,
"device": "desktop"
},
"result": [
{
"type": "video",
"rank_group": 1,
"rank_absolute": 1,
"title": "Example Video Title",
"url": "https://www.youtube.com/watch?v=example",
"channel_title": "Channel Name",
"channel_url": "https://www.youtube.com/channel/example",
"channel_image": "https://yt3.ggpht.com/example",
"duration": "10:30",
"views": 1000000,
"uploaded_date": "2024-01-01",
"description": "Video description",
"thumbnail_url": "https://i.ytimg.com/vi/example/default.jpg",
"live": false
}
]
}
}