YouTube

YouTube

Video / Shorts

per_call

Returns a video's title, description, publish date, duration, thumbnails, tags, category, channel reference and live view, like and comment counts. Works for standard videos and Shorts, so you can score any URL a client sends you.

What you get

Each call returns one video record. There is no pagination.

Endpoint

GET /v1/youtube/video-shorts

Price

$1.50

per 1,000 calls · $0.0015 per call

Cost per call

1 credit

Failed calls never charged

Parameters

target
required
string

The YouTube video or Short — its 11-character id (`dQw4w9WgXcQ`) or the full URL.

fresh
optional
enum

Bypass cached data and force a live fetch for this one call. Use it for daily monitoring or any figure you are tracking over time. Accepts `true`, `1`, `false` or `0`; anything else returns 400 `invalid_fresh`. Defaults to false and costs exactly the same as a cached call.

One of: true, 1, false, 0

Example request

Live call. Successful calls are charged; failed and empty results are not.

curl
curl "https://fastfetchz.com/v1/youtube/video-shorts?target=dQw4w9WgXcQ" \
  -H "X-API-Key: $FASTFETCHZ_KEY"

Example response

200 application/json
{
  "success": true,
  "service": {
    "platform": "YouTube",
    "name": "Video / Shorts",
    "slug": "video-shorts"
  },
  "credits_charged": 1,
  "credits_remaining": 99,
  "latency_ms": 214,
  "data": {
    "type": "video",
    "id": "21X5lGlDOfg",
    "title": "NASA Live: Official Stream of NASA TV",
    "description": "UPDATE: Our 24/7 NASA TV broadcast is being phased out as of Aug. 28, 2024. We will continue to stream live events and share new videos on our YouTube account—please subscribe to our channel to make sure you get the latest updates!\n\nWe'll also continue to stream live views from the International Space Station on this page. Visit NASA+ (https://plus.nasa.gov/) for more live events and original NASA…",
    "descriptionLinks": [
      "https://plus.nasa.gov/"
    ],
    "commentCountInt": null,
    "likeCountText": "2164103",
    "likeCountInt": 2164103,
    "viewCountText": "149,281,002",
    "viewCountInt": 149281002,
    "publishDateText": "Streamed live on Dec 28, 2018",
    "collaborators": [],
    "channel": {
      "id": "UCLA_DiR1FfKNvjuUpBHmylQ",
      "url": "https://www.youtube.com/@NASA",
      "handle": "NASA",
      "title": "NASA",
      "thumbnail": "https://yt3.ggpht.com/eIf5fNPcIcj9ig-wZBeq4stFy1lgjWTW1nLT5dYlFkHZprZ03QBiMcbpwNMB6XSBjrSFGtAGQg=s48-c-k-c0x00ffffff-no-rj"
    },
    "chapters": [],
    "thumbnail": "https://img.youtube.com/vi/21X5lGlDOfg/maxresdefault.jpg",
    "publishDate": "2018-12-28T10:40:15-08:00",
    "keywords": [
      "science",
      "space"
    ],
    "genre": "Science & Technology",
    "durationMs": 179022606000,
    "durationFormatted": "49728:30:06",
    "downloadOptions": null,
    "most_replayed": null,
    "isPaidPromotion": false
  }
}

Limits

  • Maximum per call: 1 videos.
  • Minimum per call: 1 video — a target with less data returns fewer videos, and an empty result is still a successful call.
  • Each call fetches a full page of up to 1 and costs the same either way. Pass limit to receive fewer than that in the response.
  • This endpoint returns a single record per call and is not paginated.

What this costs in practice

10,000 videos = 10,000 calls × 1 credits per call = 10,000 credits = $0.00

Priced at the Custom pack rate: 1,000,000 credits for $0.00.

Open in the pricing calculator

Error codes

401invalid_api_keyMissing or unrecognized X-API-Key header. No credits are charged.
402insufficient_creditsYour balance is below the cost of the call. Top up to continue.
403account_suspended / key_revokedThe account is suspended or the key was revoked.
429rate_limitedOver your account's requests-per-second limit. Retrying helps: the body carries retry_after_seconds and the response carries a Retry-After header. Not charged.
429monthly_cap_reachedThis key used the monthly call cap you set for it. Retrying will not help — raise the cap, use another key, or wait for the next calendar month. No Retry-After header is sent. Not charged.
500upstream_errorUnexpected failure while fulfilling the request. Not charged.