Appearance
Trending Shorts
GET /v1/youtube/shorts/trending
Fetches approximately 48 currently trending YouTube Shorts (viral/popular short-form videos) per call, returning each short's title, URL, thumbnail, view count (views), like count (likes), comment count, publish date, channel info, keywords, and duration. Each subsequent call returns a fresh batch of different trending shorts.
Authentication
All requests require the x-api-key header. Get your key at scrapecreators.com.
Example Request
curl
bash
curl 'https://api.scrapecreators.com/v1/youtube/shorts/trending' \
-H 'x-api-key: $SCRAPECREATORS_API_KEY'Node / TypeScript
js
const params = new URLSearchParams({ });
const res = await fetch(`https://api.scrapecreators.com/v1/youtube/shorts/trending?${params}`, {
headers: { 'x-api-key': process.env.SCRAPECREATORS_API_KEY }
});
const data = await res.json();
console.log(data);Python
python
import os, requests
r = requests.get(
'https://api.scrapecreators.com/v1/youtube/shorts/trending',
headers={'x-api-key': os.environ['SCRAPECREATORS_API_KEY']},
params={},
)
r.raise_for_status()
print(r.json())CLI
bash
scrapecreators youtube shorts-trending --helpExample Response
json
{
"success": true,
"shorts": [
{
"id": "ou0nl5ET0HA",
"thumbnail": "https://img.youtube.com/vi/ou0nl5ET0HA/maxresdefault.jpg",
"url": "https://www.youtube.com/watch?v=ou0nl5ET0HA",
"title": "That hooper who says their just shoes",
"description": null,
"commentCountText": "168",
"commentCountInt": 168,
"likeCountText": "151957",
"likeCountInt": 151957,
"viewCountText": "13,798,774",
"viewCountInt": 13798774,
"publishDateText": "Aug 7, 2025",
"publishDate": "2025-08-07T13:00:22-07:00",
"channel": {
"id": "UC3iObCgKLKr9xquQw7fCang",
"url": "https://www.youtube.com/@dameuniverse",
"handle": "dameuniverse",
"title": "Dame Universe"
},
"chapters": [],
"keywords": [
"Kobe"
],
"durationMs": 19000,
"durationFormatted": "00:00:19"
}
]
}Credits
Most ScrapeCreators endpoints consume 1 credit per successful response. Some heavier endpoints (transcripts, AI-driven enrichment, ad detail lookups) may cost more. Check GET /v1/credit-balance for your remaining balance.
Errors
| Status | Meaning | Action |
|---|---|---|
| 200 | Success. | Use the JSON payload. |
| 400 | Invalid or missing parameter. | Verify required parameters and value format. |
| 401 | Missing or invalid x-api-key. | Pass a valid API key in the header. |
| 402 | Out of credits. | Top up at scrapecreators.com or wait for plan reset. |
| 404 | Resource not found or private. | Confirm the handle, URL, or id and that the resource is public. |
| 429 | Rate limited. | Backoff and retry with exponential delay. |
| 500 | Server error or upstream platform failure. | Retry with backoff; report persistent errors to support. |