Skip to main content
POST
YouTube Trending Videos API

YouTube Trending Videos

Read the trending page YouTube keeps for a category in a given country and get its videos in rank order. Pick news, gaming, sports, learning, courses, fashion or shopping and a two-letter country code; each video comes back with its rank, title, channel, view count, length, thumbnail and how long ago it was posted. Run the same category and country on a schedule to see which videos and channels hold their place and which ones climb in.
category is required: news, gaming, sports, learning, courses, fashion or shopping. region is a two-letter country code and defaults to US. Returns the category’s trending videos in rank order; results_limit defaults to 50 and accepts 1 to 50.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

category is required: news, gaming, sports, learning, courses, fashion or shopping. region is a two-letter country code and defaults to US. Returns the category's trending videos in rank order; results_limit defaults to 50 and accepts 1 to 50.

category
enum<string>
required

Trending category: news, gaming, sports, learning, courses, fashion or shopping.

Available options:
courses,
fashion,
gaming,
learning,
news,
shopping,
sports
Minimum string length: 1
callback_url
string<uri>
region
string
default:US

Two-letter country code of the trending page, such as US, GB or JP.

Minimum string length: 1
Pattern: ^[A-Za-z]{2}$
results_limit
integer
default:50
Required range: 1 <= x <= 50

Response

Task accepted

code
integer
data
object