Skip to main content
GET
/
v1
/
youtube
/
search
Search YouTube for videos, channels, and playlists
curl --request GET \
  --url https://api.urltodata.ai/v1/youtube/search \
  --header 'Authorization: Bearer <token>'
{
  "query": "<string>",
  "results": [
    {
      "type": "video",
      "id": "<string>",
      "title": "<string>",
      "description": "<string>",
      "thumbnail": "<string>",
      "duration": 123,
      "viewCount": 123,
      "uploadDate": "<string>",
      "channel": {
        "id": "<string>",
        "name": "<string>"
      },
      "handle": "<string>",
      "videoCount": 123
    }
  ],
  "totalResults": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.urltodata.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
default:your-api-key
required

API key as Bearer token (e.g. Bearer mp_abc123_secret)

Query Parameters

​
query
string
required

Search query

​
type
enum<string>

Filter by type

Available options:
all,
video,
channel,
playlist
​
uploadDate
enum<string>

Filter by upload date

Available options:
all,
hour,
today,
week,
month,
year
​
duration
enum<string>

Filter by duration

Available options:
all,
short,
medium,
long
​
sortBy
enum<string>

Sort results

Available options:
relevance,
rating,
date,
views
​
limit
integer

Max results

Response

200 - application/json

Search results

​
query
string
​
results
object[]
​
totalResults
integer