# YouTube — Hashtag videos

Fetch recent videos tagged with a given hashtag HTML version: https://www.socialrouter.io/services/youtube/hashtag.videos

## Call it

```
POST https://api.socialrouter.io/v1/extract/youtube/hashtag.videos
Authorization: Bearer <your API key>
Content-Type: application/json

{ "urls": ["https://www.youtube.com/hashtag/ai"] }
```

The response shape does not depend on which offer ran; `served_by` names the one that did.

## Input

- `https://www.youtube.com/hashtag/<tag>` — Pass the hashtag page URL, not a bare #tag.. Example: `https://www.youtube.com/hashtag/ai`

## Options

- `sortingOrder` (string) — Result ordering, as the YouTube UI names it (e.g. relevance, date, views).
- `videoType` (string) — Restrict to a video type (e.g. video, movie).
- `lengthFilter` (string) — Video length filter (e.g. under4, between420, over20).
- `isHD` (boolean) — Only HD videos.
- `hasSubtitles` (boolean) — Only videos with subtitles.
- `hasCC` (boolean) — Only Creative Commons videos.
- `is3D` (boolean) — Only 3D videos.
- `isLive` (boolean) — Only live streams.
- `is4K` (boolean) — Only 4K videos.
- `is360` (boolean) — Only 360° videos.
- `hasLocation` (boolean) — Only geotagged videos.
- `isHDR` (boolean) — Only HDR videos.
- `isVR180` (boolean) — Only VR180 videos.

## Offers, in failover order

1. `apify/streamers` — $0.0055 per record, up to 100 inputs per call

## See also

- Catalogue as JSON: https://api.socialrouter.io/v1/services
- OpenAPI 3.1 spec: https://api.socialrouter.io/v1/openapi.json
- Agent overview: https://www.socialrouter.io/llms.txt
- Sitemap: https://www.socialrouter.io/sitemap.xml
- Docs: https://docs.socialrouter.io