Video search

Find public videos.

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

curl --get 'https://webstractor.com/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` finds public video pages from supported sources. Use `youtube` for YouTube-only results. Default: `any`.
`sort`	No	`relevance` or newest-first `date`. Default: `relevance`. Use `date` when the user asks for the latest video.
`creator`	No	Exact public creator name, 1–80 characters. Combine with `sort=date` and `limit=1` for that creator’s latest matching upload.
`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, its displayed relative 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",
    "videoSort": "relevance",
    "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",
    "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.
For “give me the latest video of Taylor Swift,” send q=Taylor Swift, creator=Taylor Swift, platform=youtube, sort=date, and limit=1. Omit creator when the user wants any recent video about the subject.
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, exact creator constraint, locale, ordering, limit, format, cache, metering, and rate-limit behavior. Agents should set creator, sort=date, and limit=1 when the user asks for a named creator’s latest upload.