# YouTube Search Advanced API (https://www.socialcrawl.dev/platforms/youtube/search-advanced)

> Searches YouTube videos with the full filter set — sort `order`, `duration`, live/upcoming `event_type`, Creative-Commons `license`, `category`, `region`, `language`, and `published_after`/`published_before` date windows — returning video id, title, thumbnail, channel, and publish time, plus a `cursor` for the next page. Results are always videos.

TL;DR: `GET /v1/youtube/search/advanced` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search query. |
| `order` | no | Sort order: date, rating, relevance (default), title, videoCount, viewCount. |
| `duration` | no | Video length: short (<4m), medium (4–20m), long (>20m), any. |
| `event_type` | no | Broadcast type: live, upcoming, completed. |
| `license` | no | License filter: creativeCommon, youtube, any. |
| `category` | no | YouTube video category id (e.g. 10 = Music). |
| `region` | no | ISO 3166-1 alpha-2 country code. |
| `language` | no | Preferred result language (ISO 639-1). |
| `published_after` | no | RFC-3339 datetime lower bound (e.g. 2026-01-01T00:00:00Z). |
| `published_before` | no | RFC-3339 datetime upper bound. |
| `channel_id` | no | Restrict results to a single channel id. |
| `max_results` | no | Maximum number of videos to return (1–50). |
| `cursor` | no | Pagination cursor from a previous response — fetches the next page. |
| `safe_search` | no | Safe-search filter: none, moderate, strict. |
| `video_caption` | no | Caption filter: any, closedCaption, none. |
| `video_definition` | no | Quality filter: any, high, standard. |
| `video_dimension` | no | Dimension filter: 2d, 3d, any. |
| `video_embeddable` | no | Restrict to embeddable videos: true, any. |
| `video_type` | no | Type filter: any, episode, movie. |
| `topic_id` | no | Restrict to a Freebase topic id (e.g. /m/04rlf for music). |
| `location` | no | Latitude,longitude center for a geo search (e.g. 37.42307,-122.08427). Must be used together with location_radius. |
| `location_radius` | no | Radius around location with a unit suffix (e.g. 50km, 10mi). Must be used together with location. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/youtube/search/advanced?query=lofi%20hip%20hop" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I run an advanced YouTube video search?

Send a GET to /v1/youtube/search/advanced with a query plus any filters. Results are always videos, returned with video ID, title, thumbnail, channel, and publish time.

### What filters does advanced search support?

Sort order, duration (short, medium, long), event_type (live, upcoming, completed), license, category, region, language, and published_after / published_before date windows.

### How do I find videos published in a date range?

Pass published_after and published_before as RFC-3339 datetimes, for example 2026-01-01T00:00:00Z, to bound results to that window.

### How is this different from the basic search endpoint?

The basic /v1/youtube/search endpoint keeps things simple; search/advanced exposes the full YouTube filter set for precise, video-only queries.

### How much does advanced search cost?

It is a standard endpoint at 1 credit per request. New accounts get 100 free credits and there is no daily quota.

See the full YouTube API: https://www.socialcrawl.dev/platforms/youtube

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to search YouTube videos with date and duration filters via API
- YouTube advanced search API without Data API quota