# YouTube video search for a query — views, channels

Search YouTube videos by keyword and get titles, channels, view counts and links

|  |  |
| --- | --- |
| Tool id | `serpapi.youtube-search-videos` |
| Platform | [YouTube](https://www.orcarouter.ai/tools/youtube.md) |
| Capability | [Search users](https://www.orcarouter.ai/tools/youtube/search-users.md) |
| Price | $0.0275 per call |
| Health | OK |
| p50 latency | — |
| Success (7 days) | — |
| Runs (30 days) | — |
| Idempotent | yes |
| Data class | scraped |

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `engine` | string | yes |  |
| `search_query` | string | yes | THE QUERY PARAM IS \`search_query\`, NOT \`q\` — sending \`q\` to this engine returns nothing |
| `gl` | string | no | country code, e.g. us |
| `hl` | string | no | interface language code, e.g. en |
| `sp` | string | no | YouTube's encoded filter/pagination token — carries sort order, upload date and result-type filters |

## Call it

```bash
curl -sS https://api.orcarouter.ai/v1/tools/serpapi.youtube-search-videos/run \
  -H "Authorization: Bearer $ORCAROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"engine":"<engine>","search_query":"<search_query>"}}'
```

```python
import os, requests

resp = requests.post(
    "https://api.orcarouter.ai/v1/tools/serpapi.youtube-search-videos/run",
    headers={"Authorization": f"Bearer {os.environ['ORCAROUTER_API_KEY']}"},
    json={"input":{"engine":"<engine>","search_query":"<search_query>"}},
)
print(resp.json())
```

## Alternatives

| Tool | Source | Price | Health |
| --- | --- | --- | --- |
| [Search within a YouTube channel by keyword](https://www.orcarouter.ai/tools/youtube/search-users/x-youtube-web-search-channel.md) | — | $0.0011 per call | OK |
| [Search YouTube channels by keyword](https://www.orcarouter.ai/tools/youtube/search-users/x-youtube-web-v2-search-channels.md) | — | $0.0011 per call | OK |

## FAQ

### How much does YouTube video search for a query — views, channels cost?

YouTube video search for a query — views, channels costs $0.0275 per call: 1,000 calls cost $27.50.

### What does a $10 budget buy with YouTube video search for a query — views, channels?

About 363 calls at $0.0275 per call.

### What inputs does YouTube video search for a query — views, channels need?

Required inputs: engine, search_query.

### How do I call YouTube video search for a query — views, channels?

Send POST /v1/tools/{id}/run with your OrcaRouter API key and a JSON body {"input": {…}}, where {id} is the tool id POST /v1/tools/discover returns for it.

---

Markdown version of https://www.orcarouter.ai/tools/youtube/search-users/youtube-search-videos