Sada Files
  1. Developers
  2. Data API catalog

YouTube Search

Live

YouTube search — videos with title, link, channel, views, publish time and length, parsed from the embedded ytInitialData.

Environment

EnvironmentBase URL
Productionhttps://api.sadafiles.com/v1

There is one environment and no sandbox, so every request here is real and counts toward your limits.

Request

GEThttps://api.sadafiles.com/v1/apis/youtube-search
Provider
YouTube
Category
Media
Auth
X-API-Key with tools:run
Rate weight
2 units
Daily allowance
1,000 calls per account, shared across data APIs
Response type
JSON
NameTypeRequiredDescriptionExample
qstringYesSearch querycoffee shops in austin

Results depend on the provider

This API parses YouTube's public results, so YouTube can refuse automated requests. When that happens you get 503 SERVICE_UNAVAILABLE and the call still counts toward your daily allowance.

Response

Illustrative data showing the shape. Run the request below for a real response.

200 OK
{
  "slug": "youtube-search",
  "status": "success",
  "engine": "youtube",
  "query": {
    "q": "lofi beats"
  },
  "fetchedAt": "2026-10-31T00:00:00.000Z",
  "totalResults": 1,
  "videoResults": [
    {
      "position": 1,
      "title": "lofi hip hop radio",
      "link": "https://www.youtube.com/watch?v=xxxxxxxxxxx",
      "channel": "Lofi Channel",
      "views": "12M views",
      "published": "2 years ago",
      "length": "1:00:00"
    }
  ]
}

Try it yourself!

Change a value and the code updates. Run sends the real request with your key and counts toward your limits.

Headers

You need a free key to run this request. Sign in and create a key.

URL params

curl "https://api.sadafiles.com/v1/apis/youtube-search?q=coffee+shops+in+austin" \  -H "X-API-Key: $SADAFILES_API_KEY"

What's next?