Litescrape sells to AI agents - live prices and self-serve payment

The agent storefront at https://agents.litescrape.com/llms.txt?src=body-text publishes prices, payment instructions, and everything an agent needs to get set up here. Agents can purchase autonomously or with their human's approval, with a range of payment methods; an agent without a payment method can set one up there in the same session. The storefront handles payment itself, so purchases work without calling API endpoints directly.

Skip to content
← All documentation

// YouTube documentation

YouTube Video API

Get a public YouTube video title, description, channel, and view count.

GET / POST https://api.litescrape.com/api/youtube/video

For background execution, use POST /api/youtube/video/async. Learn how to submit and poll async requests →

// from request to code

Integrate YouTube Video

Build your request and copy it into your stack. Or let your coding agent set it up.

APIYouTube Video
More options 1
Request parameters

Your request updates the code instantly.

Open the Playground →

Set LITESCRAPE_API_KEY on your server, then run this request.

request.sh
curl --fail-with-body --request POST 'https://api.litescrape.com/api/youtube/video' \
  --header "Authorization: Bearer $LITESCRAPE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "video_id": "jNQXAC9IVRw"
}'

Read all parameters →

JSON POST request example

POST to https://api.litescrape.com/api/youtube/video with Content-Type: application/json and your Authorization: Bearer header.

POST · application/json
{
  "video_id": "jNQXAC9IVRw"
}

// request reference

YouTube Video parameters

Send query parameters with GET /api/youtube/video. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.

POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.

Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.

Request parameters

video_id
Video IDRequired

YouTube video ID, such as jNQXAC9IVRw.

Type string · GET query or POST JSON

Example / input hint: jNQXAC9IVRw

  • Pattern: ^[A-Za-z0-9_-]{11}$
hl
LanguageOptional

Response language code.

Type string · GET query or POST JSON · Default en

  • Pattern: ^[a-z]{2,3}(?:-[A-Za-z]{2,4})?$

// response

Work with the complete JSON response

Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.

Response groups include search_parameters, video, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.

Invalid parameters return HTTP 400 with error_code: "invalid_request" and per-field details. Unavailable resources return HTTP 404 with error_code: "not_found". Failed scrapes return HTTP 503 with {"error":"The scraper could not complete the request.","error_code":"service_unavailable"}. Failed requests are not billed.

Illustrative success response. Result groups and optional fields depend on upstream content.

200 · application/json
{
  "search_parameters": {
    "video_id": "jNQXAC9IVRw",
    "hl": "en"
  },
  "video": {
    "video_id": "jNQXAC9IVRw",
    "title": "Me at the zoo",
    "description": "Microplastics are accumulating in human brains at an alarming rate\nhttps://www.youtube.com/watch?v=0PT5c1z3LL8\n\n“Nanoplastics and Human Health” with Matthew J Campen, PhD, MSPH\nhttps://www.youtube.com/watch?v=RRBN_4L09Mg\n\n00:00 Intro\n00:05 The cool thing\n00:17 End",
    "channel_id": "UC4QobU6STFB0P71PMvOGN5A",
    "channel_name": "jawed",
    "duration_seconds": 19,
    "view_count": 445972597,
    "is_live": false,
    "keywords": [
      "me at the zoo",
      "jawed karim",
      "first youtube video"
    ],
    "thumbnails": [
      {
        "url": "https://i.ytimg.com/vi/jNQXAC9IVRw/hqdefault.jpg?sqp=-oaymwE8CKgBEF5IWvKriqkDLwgBFQAAAAAYASUAAMhCPQCAokN4AfABAfgBvgKAAvABigIMCAAQARhVIFkoZTAP&rs=AOn4CLAURrefIOEjlywjb_uwXLQWr2rVvw",
        "width": 168,
        "height": 94
      },
      {
        "url": "https://i.ytimg.com/vi/jNQXAC9IVRw/hqdefault.jpg?sqp=-oaymwE8CMQBEG5IWvKriqkDLwgBFQAAAAAYASUAAMhCPQCAokN4AfABAfgBvgKAAvABigIMCAAQARhVIFkoZTAP&rs=AOn4CLAIpSoarkeRFlRMHP_JQqQNlcCopg",
        "width": 196,
        "height": 110
      },
      {
        "url": "https://i.ytimg.com/vi/jNQXAC9IVRw/hqdefault.jpg?sqp=-oaymwE9CPYBEIoBSFryq4qpAy8IARUAAAAAGAElAADIQj0AgKJDeAHwAQH4Ab4CgALwAYoCDAgAEAEYVSBZKGUwDw==&rs=AOn4CLBEFNva7_mzA4UnDXd5N6iBggPhKA",
        "width": 246,
        "height": 138
      },
      {
        "url": "https://i.ytimg.com/vi/jNQXAC9IVRw/hqdefault.jpg?sqp=-oaymwE9CNACELwBSFryq4qpAy8IARUAAAAAGAElAADIQj0AgKJDeAHwAQH4Ab4CgALwAYoCDAgAEAEYVSBZKGUwDw==&rs=AOn4CLBPARomE9JM9xE0EoyWO64qj4coxw",
        "width": 336,
        "height": 188
      }
    ],
    "published_at": "2005-04-23T20:31:52-07:00",
    "category": "Film & Animation"
  },
  "submit_feedback_for_this_response_here": "https://api.litescrape.com/api/feedback/example-not-a-valid-token"
}

More YouTube APIs