InsightSocial APIVideos › Trending
Returns the trending videos for a country and category, each with title, thumbnail, duration, view, like and comment counts, channel, and publish time.
Use it to see what is popular in a given country right now; shorts/trending covers Shorts and takes no filters.
Metered: 20–120 credits. We reserve the ceiling when the call starts and charge what it actually used when it finishes.
Re-running the exact same call within 1h is free.
Paginates by cursor — see Pagination.
Authorization
apiKey Your key from the dashboard. It starts with isk_.
In: header
Query Parameters
ISO 3166-1 alpha-2 country code (e.g. US, GB, KR).
YouTube video category id (e.g. 10 = Music, 24 = Entertainment).
Localization language (ISO 639-1) for titles/metadata.
Maximum number of videos to return (1-50).
Pagination cursor from a previous response: fetches the next page.
Set to channel (one token only) to add each row's channel stats in this one call. channel puts the channel's subscriber count on post.ext.author_followers (YouTube's own figure, which it rounds to three significant figures above 1,000) and fills the channel's post.author.display_name, .avatar_url and .username where missing. Each join adds 0.2 to 0.7 seconds on a fresh page (one lookup per 50 ids, never more than 8 seconds). Read data.hydration for the rows, lookups, credits held and kept, and the time.
Value in
- "channel"
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/youtube/videos/trending"{ "success": true, "platform": "instagram", "endpoint": "/v1/instagram/profile/posts", "data": { "items": [ "…" ], "dropped": 0 }, "pagination": { "next_cursor": "is2.eyJwIjoyfQ", "has_more": true, "page_size": 12 }, "credits_used": 20, "credits_remaining": 9980, "request_id": "req_1a2b3c4d5e6f", "cached": false, "idempotent_replay": false, "charge_reason": "miss", "free_call": false}