Video search results
dataforseo/serp_youtube_organic_liveReturn video, channel, and playlist results for a keyword.
- call
- $0.004
- DataForSEO
- 3 min
Overview
Searches the video platform and returns the ranked blocks of results it produces. Items are typed: videos come back with title, canonical URL, video identifier, publishing channel, view count, publication date, and duration; channels come back with their subscriber-facing metadata; playlists come back with a preview of what they contain. Because the platform lays results out in named blocks, each item carries a block rank and block name alongside its overall position, and parsing depth is expressed in blocks rather than individual results.
One results page of typed video, channel, and playlist items with their metadata and block rank.
Input
These go in the input object of the run request.
| Field | Type | Required | Description |
|---|---|---|---|
| keyword | string | Yes | The search query to run, up to 700 characters. |
| location_code | integer | Yes | Which market to search from. |
| language_code | string | Yes | Interface and result language. |
| block_depth | integer | No | How many result blocks to parse. |
| device | string | No | Which device to emulate. |
Requests up to 1 MB.
Example
A call that works, with your own key.
curl https://gateway.agentsky.dev/v1/run \
-H "authorization: Bearer $AGENTSKY_API_KEY" \
-H "content-type: application/json" \
-d '{"provider":"dataforseo","endpoint":"serp_youtube_organic_live","input":{"keyword":"how to make sourdough","location_code":2840,"language_code":"en","block_depth":20}}'Pricing
$0.004 per call on the default plan. That is the list price; when the provider reports what a call actually cost, you are billed that instead. Every run carries its price in the response.