Skip to content
truescrape
Free key

Contents

Site

YouTube Trending Shorts API

Open in ChatGPTOpen in ClaudeOpen in Gemini

Shorts YouTube is currently surfacing, by region. Note that YouTube retired the global Trending feed (/feed/trending now serves the ordinary home feed), so this reads the ranked Shorts surface instead, which is what still exists. Results differ per request; it is deliberately not subscribable. With extra_fetch=true, each Short is fetched individually to fill its exact view count, publish date and duration. Costs 1 credit per item fetched, up to the page size. Calls cost 1 credit each. A cache hit is free, and a failed or empty response is never charged.

Try it

Prefilled with the request that produced the example below. No key yet? Get a free key.

Request

GET/v1/youtube/shorts/trending
ParameterTypeRequiredDescription
regionstringnoISO 3166-1 alpha-2 country codedefaults to US
cursorstringnopagination.cursor from a previous response
extra_fetchbooleannoWhen true, fetches each item's own page to fill fields the list page leaves null. Costs 1 extra credit per page fetched, up to the page size.

Also accepts cache_max_age (a hit costs 0 credits) and include_raw (returns the untouched upstream payload under raw).

curl
curl "$API/v1/youtube/shorts/trending?region=US&cache_max_age=7d" \
  -H "x-api-key: $KEY"
JavaScript
const query = new URLSearchParams({
  region: 'US',
  cache_max_age: '7d',
});

const response = await fetch(`${API}/v1/youtube/shorts/trending?${query}`, {
  headers: { 'x-api-key': KEY },
});

const body = await response.json();
if (!body.success) throw new Error(body.error.code);

// 1 credit, 0 on a cache hit
console.log(body.data, body.meta.creditsCharged);
Python
import os, httpx

r = httpx.get(
    f"{os.environ['API']}/v1/youtube/shorts/trending",
    params={
        "region": "US",
        "cache_max_age": "7d",
    },
    headers={"x-api-key": os.environ["KEY"]},
    timeout=30,
)

body = r.json()
if not body["success"]:
    raise RuntimeError(body["error"]["code"])

print(body["data"], body["meta"]["creditsCharged"])

Example response

Captured on , with raw removed and lists cut to two items. A live call returns current data.

response
{
  "success": true,
  "data": {
    "items": [
      {
        "platform": "youtube",
        "id": "Gw1y8t36tBo",
        "type": "short",
        "url": "https://www.youtube.com/shorts/Gw1y8t36tBo",
        "title": "#Shorts#Rumi#cosplay#Spider-Man",
        "text": null,
        "authorId": null,
        "authorHandle": null,
        "authorName": null,
        "thumbnailUrl": "https://example.com/media/1.jpg",
        "mediaUrls": [],
        "durationSeconds": null,
        "viewCount": 54000000,
        "likeCount": null,
        "commentCount": null,
        "shareCount": null,
        "hashtags": [
          "Shorts",
          "Rumi"
        ],
        "mentions": [],
        "isSponsored": null,
        "publishedAt": null,
        "fetchedAt": "2026-10-21T01:55:28.707Z"
      },
      {
        "platform": "youtube",
        "id": "hquTU3_nZJI",
        "type": "short",
        "url": "https://www.youtube.com/shorts/hquTU3_nZJI",
        "title": "Ôi hết cả hồn #xuhuongyoutube #shorts",
        "text": null,
        "authorId": null,
        "authorHandle": null,
        "authorName": null,
        "thumbnailUrl": "https://example.com/media/1.jpg",
        "mediaUrls": [],
        "durationSeconds": null,
        "viewCount": 51000000,
        "likeCount": null,
        "commentCount": null,
        "shareCount": null,
        "hashtags": [
          "xuhuongyoutube",
          "shorts"
        ],
        "mentions": [],
        "isSponsored": null,
        "publishedAt": null,
        "fetchedAt": "2026-10-21T01:55:28.707Z"
      }
    ]
  },
  "pagination": {
    "cursor": "eyJ0IjoiNHFtRnNnTGRBUklKUmtWb1lYTm9kR0ZuR3JnQlEwTlNObVJGVGtSVVZrWkRWVzA1TW1ReVpGcGpNRTV1VjI1d2FGSjZiRFZhUldoT1ZUQnNjbUZHVmxaaVZWcFJWMVJGTlZkdFRuQk5WbXhUWVhwc2NWcEdWbE5SYkVsNlkwZEdhbEl5VW5wWFZFWlRZMVUwZUZOdGFGcFdNMUp0Vm1wT1FtRlZWbEppTVVKUFZrYzVORlJ1Y0hKbFZUVlZWVlJPVDJWcmF6QlVhMUpTVGxWMGJrMUZkRVJsYlhneFZGVmFWMkpXYjNoVVZGWnJVbTVDUXpablZVdERaMXA2WVVjNWVXUklUVmxCZHlVelJDVXpSSm9DRkdKeWIzZHpaUzFtWldWa1JrVm9ZWE5vZEdGbiIsInYiOiJDZ3MzVUZkdlMwOXVWMGg1UlNpUXQtRFdCaklLQ2dKRVJSSUVFZ0FnRkdLeUFncXZBa04xUVVKRFFWVlRhMmRGUWpoUlduVmFiRjlhVjBWaldVRmlWRWxWU1hZeVlteGFiVnBYU0hOclZHZ3ROM2xrVjBZd00xUmlhMjB6VkRBMFdGaHpWMWxhZG1jMmFVUlZTRTltUmpGdlVVTkJNa1paWlU5blpIbEVlakpHZG13elVrRkRXbmxPWjJWaVNYQm1RbXAxZEd4Q05uVjVYM1JmVkVsV2FUUllNSFkwWTNCellUWndOblYxYlc1SWJYVlpUWFl0WVY5aWRYRmxia05hU21ObWJ6bFJNVVpZZVVGcmQyWk1aV2R3VHpGbU1GRkJNSEprZW5sMlVUWlBWbk5EWkZaR1ZHVTNlRmxJUTNkU1oyTkRaMFpOYTFWQ00zRnRaRlE1ZUV4cVZtSnFiazVKVFhsRlNtRnZia3QyTWw5VVozSjBSWGhtZDNaWVlsTmpkRTAyVmxoUGVYRnhkekJ2Y1RKaVdsUnpjWGgxY0dFdFpUSmlVbGR1VHpJMVVYUXRXbEpuWmxOWGFrUjJNVEF5VWw5M09BJTNEJTNEIn0",
    "hasMore": true,
    "count": 36
  },
  "meta": {
    "platform": "youtube",
    "endpoint": "youtube.trendingShorts",
    "creditsCharged": 1,
    "cached": false,
    "cacheAgeSeconds": null,
    "durationMs": 353,
    "requestId": "req_1wwz3z1szdgkgaue6xmy"
  }
}

Returns

Returns a list of Post in data.items.

Cost and behaviour

Credits1 per live request, 0 on a cache hit
Cacheableyes: cache_max_age accepts a cached copy
Batchableyes: usable as a target in POST /v1/jobs/batch
Subscribableno

Other YouTube endpoints

All YouTube endpointsThe unified schema