# YouTube Video Search

> YouTube search results as JSON: title, channel, views, length, date, link

- Vendor: `youtubevideosearch` · version 1.0 · category Video & Images · tags youtube, video search, video analytics, creator research, youtube data
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/youtubevideosearch
- This document: https://apiclay.com/docs/youtubevideosearch.md
- OpenAPI 3.1: https://apiclay.com/api/youtubevideosearch/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `youtubevideosearch`
- Updated: 2026-11-18

## About

## YouTube Video Search

Search YouTube and get the matching videos as clean JSON.

### Routes

#### /search

Videos for a search: video_id, title, channel, channel_url, views, duration, published, snippet, thumbnail, url. Rendered in a browser (adds the platform browser fee).

```bash
curl -G 'https://api.apiclay.com/v1/api/youtubevideosearch/search' -H 'token: YOUR_TOKEN' --data-urlencode 'search_query=python tutorial'
```

### Notes

Data comes from public YouTube pages. Not affiliated with YouTube or Google.

## Pricing

- Pay as you go: 0.01 credits/request
- Trial: 10 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.
- Browser rendering (0.005 credits per rendered call): A call that renders the page in a browser adds the browser fee to the route price: routes with render mode js, routes with render mode auto when the call switches to the browser (pre-charged, refunded when it does not), and calls sent with `X-ApiClay-Render: js`.
- Trial and plan requests still pay the browser fee.
- Response headers on a billed call: `X-ApiClay-Browser-Fee`.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /search — Search videos
- Gateway: `GET https://api.apiclay.com/v1/api/youtubevideosearch/search`
- Public query params: `search_query` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 5.5 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/youtubevideosearch/search?search_query=<search_query>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
