fetchproof.

/v1/youtube/shorts/trending

GET

Trending Shorts

Get about 48 trending Shorts per request. Repeated requests can return new Shorts.

Credit cost

Default: 1 credit

How charges are determined

Cost is decided per call, not per endpoint: the same operation can cost different amounts depending on what it returns.

A call that fails costs 0 credits. A result served from cache costs 0 credits.

`default` is the cost when no rule matches. Rules are evaluated in order and the first whose conditions all hold wins.

A `when` condition is one of: `param` (the request parameter is true), `outcome` (the classifier's outcome), `empty` / `nonEmpty` (a response field is empty and absent, or a non-empty array or string), `flag` (a response field is exactly true).

A cost of `{ perStartedMinute: n, of: [fields] }` is n x max(1, ceil(seconds / 60)), so even a short result bills at least one minute.

Cache supportNot specified in the published contract.
PaginationNo explicit pagination metadata in the published contract. Consult the parameters and response fields below.

Parameters

No parameters declared.

Request examples

Replace placeholder values and supply your own API key. For operations with a request body, populate the body using the schema above.

cURL
curl --request GET 'https://api.fetchproof.com/v1/youtube/shorts/trending' \
  --header 'x-api-key: YOUR_API_KEY'
JavaScript
const response = await fetch("https://api.fetchproof.com/v1/youtube/shorts/trending", {
  method: 'GET',
  headers: { 'x-api-key': process.env.FETCHPROOF_API_KEY }
});
console.log(await response.text());
Python
import os
import requests

response = requests.get("https://api.fetchproof.com/v1/youtube/shorts/trending",
    headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]})
print(response.text)

Responses

200Success. Envelope: success / credits_remaining / credits_charged.

application/json

object

successrequired

boolean

credits_remainingrequired

integer

credits_chargedrequired

integer

shortsrequired

array

Array items

object

idrequired

string

thumbnailrequired

string

urlrequired

string

titlerequired

string

descriptionrequired

string

commentCountTextrequired

string

commentCountIntrequired

integer

likeCountTextoptional

string

likeCountIntrequired

integer

viewCountTextrequired

string

viewCountIntrequired

integer

publishDateTextrequired

string

publishDaterequired

string

channelrequired

object

idrequired

string

urlrequired

string

handlerequired

string

titlerequired

string

chaptersrequired

array

keywordsrequired

array

Array items

string

durationMsrequired

integer

durationFormattedrequired

string

401Invalid or missing x-api-key
402No credits remaining
403Upstream denied (age gate, audience controls)
404Resource or endpoint not found
429Rate limited