↑ ↓ to move ↵ to open
YouTube API reference

YouTube Trending Shorts

youtube.feed.trending

Get a sample of the Shorts YouTube recommends to a visitor right now.

At a glance

Endpoint ID
youtube.feed.trending
Price
0.75–1 credits per call; failed calls are free
Runs for up to
60 seconds
Request
POST /execute
Run an endpoint
MCP tool when pinned
youtube__feed__trending
Pin tools
OpenAPI
openapi.json
Download

Request

Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "youtube.feed.trending",  "input": {    "count": 5  }}'

Input

FieldTypeRequiredWhat it doesExample
count integer no Requested number of Shorts in the sample. From 1 to 35. Default: 10. 5

Response

A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.

This is results[0].data from a real run:

results[0].data
{  "count": 1,  "shorts": [    {      "title": "1 in a trillion #basketball #shorts",      "like_count": 431000,      "channel": "@HoopsEmpire_Official",      "channel_id": "UC1nubW_LylhVtQN6gSfrRug",      "like_count_approximate": true,      "like_count_text": "431K",      "url": "https://www.youtube.com/shorts/hitjAtT7Ij4",      "video_id": "hitjAtT7Ij4",      "thumbnails": [        {          "height": 1920,          "url": "https://i.ytimg.com/vi/hitjAtT7Ij4/frame0.jpg",          "width": 1080        }      ]    }  ]}

Fields

FieldTypeWhat it isExample
shorts[].title string The short's title. 1 in a trillion #basketball #shorts
shorts[].like_count integer Likes, as YouTube shows them. 431,000
shorts[].channel string The channel that posted it. @HoopsEmpire_Official
shorts[].channel_id string YouTube's ID for the channel. UC1nubW_LylhVtQN6gSfrRug
shorts[].like_count_approximate boolean Whether the like count comes from a rounded figure. true
shorts[].like_count_text string Likes as YouTube writes them. 431K
shorts[].thumbnails array Thumbnail images in different sizes. 1 records
shorts[].thumbnails[].height integer 1920
shorts[].thumbnails[].url string Link to the thumbnail image. https://i.ytimg.com/vi/hitjAtT7Ij4/frame0.jpg
shorts[].thumbnails[].width integer 1080
shorts[].url string The short's link. https://www.youtube.com/shorts/hitjAtT7Ij4
shorts[].video_id string YouTube's ID for the video. hitjAtT7Ij4
count integer How many shorts this answer holds. 1
shorts array Trending shorts. 1 records

If a call fails

A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.

Other YouTube endpoints

Something missing or unclear? Ask the team that builds the YouTube endpoints.