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

X-API-Key
string
header
required

Body

application/json
keyword
string
required

Search term

Example:

"audi"

language_code
string
default:en

Language code

Example:

"en"

location_code
integer
default:2840

Location code (2840 for US)

Example:

2840

device
enum<string>
default:desktop

Device type

Available options:
desktop,
mobile
Example:

"desktop"

Response

200 - application/json
Successful response
success
boolean
Example:

true

data
object