Video search

Find public videos.

Use one provider-neutral GET endpoint to discover public video pages. Results are ordered by relevance and returned as readable Markdown or schema-v1 JSON.

curl --get 'https://extractor.sh/api/videos' \
  --data-urlencode 'q=Cloudflare Workers tutorial' \
  --data-urlencode 'limit=10' \
  --data-urlencode 'platform=youtube' \
  --data-urlencode 'format=json'

Query parameters

Parameter	Required	Description
`q`	Yes	Search query, from 1 to 200 characters.
`limit`	No	1–20 ordered results. Default: 10.
`language`	No	Canonical BCP 47 language tag. Default: `en-US`.
`country`	No	Two-letter country code. Default: `US`.
`platform`	No	`any` (default) or `youtube` for YouTube-only results.
`format`	No	`json` or `markdown`. Default: `json`.

JSON response

JSON returns a video-search feed. Every item is a semantic video entity with a public source-page URL. Creator, publication time, description, duration, view count, and thumbnail fields are included only when the search result exposes them.

{
  "schemaVersion": 1,
  "type": "feed",
  "source": "video-search",
  "attributes": {
    "feedType": "video-search",
    "query": "Cloudflare Workers tutorial",
    "language": "en-US",
    "country": "US",
    "resultCount": 1
  },
  "items": [{
    "type": "video",
    "source": "video-search",
    "url": "https://video.example/watch/example",
    "title": "Cloudflare Workers tutorial",
    "author": "Example Creator",
    "publishedAt": "2026-06-23T00:00:00.000Z",
    "content": "A practical introduction.",
    "media": [{ "type": "image", "url": "https://video.example/example.jpg", "alt": "Cloudflare Workers tutorial" }],
    "attributes": { "durationSeconds": 323, "viewCount": 1234 }
  }]
}

Behavior and limits

Safe search is strict and cannot be disabled.
The endpoint searches public video pages; it does not return direct stream or download URLs.
Use platform=youtube when the AI specifically needs YouTube watch results.
Successful searches are cached for up to one hour. A cache hit is free.
A successful uncached request uses one anonymous allowance slot or one account credit.
Use the returned source page and preview metadata according to the source’s terms and rights.

MCP

Hosted MCP clients can call search_videos with the same query, locale, limit, format, cache, metering, and rate-limit behavior.