Extract structured video metadata from any URL via Diffbot's Video API, paid per call over MPP.
What it does
This endpoint wraps Diffbot's Video extraction API behind the Locus MPP (Micropayment Protocol) gateway. You POST a video page URL and receive structured data about the video — title, description, embed URL, duration, and other metadata that Diffbot extracts from the page. Payment is handled automatically via the MPP 402-challenge flow using the Tempo settlement method on pathUSD.
The video endpoint is one of several Diffbot extraction APIs available through this same MPP gateway, which also exposes article, product, discussion, image, event, list, job-posting, and auto-detect (analyze) endpoints. Each call costs 4,200 base units of pathUSD (6 decimals), which equals $0.0042 per request. The request schema accepts a required `url` parameter plus optional `fields`, `timeout`, and `discussion` parameters.
Note that the probe did not receive a 402 challenge on HEAD or GET — this is expected because the endpoint is a POST-only route. The OpenAPI spec clearly documents the POST method with full request schema and payment info, so the endpoint should be considered available. No response schema is documented, so the exact shape of the returned video object must be inferred from Diffbot's own documentation at docs.diffbot.com.
Capabilities
Use cases
- —Extracting structured metadata (title, duration, embed URL) from video pages for indexing or cataloging
- —Building media monitoring pipelines that ingest video content metadata from arbitrary URLs
- —Enriching a content database with video details scraped from publisher sites
- —Agents that need to understand what a video page contains without rendering it
Fit
Best for
- —Programmatic extraction of video metadata from arbitrary web pages
- —Pay-per-call usage without a Diffbot subscription
- —AI agents that need structured video data from URLs on-the-fly
Not for
- —Downloading or transcoding actual video files — this extracts metadata only
- —High-volume bulk scraping where a direct Diffbot subscription would be more cost-effective
- —Extracting data from pages that require authentication or are behind paywalls
Quick start
curl -X POST https://diffbot.mpp.paywithlocus.com/diffbot/video \
-H "Content-Type: application/json" \
-d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'Example
Request
{
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"fields": "links,meta",
"timeout": 30000,
"discussion": false
}Endpoint
Quality
The OpenAPI spec provides a clear request schema and payment info for the video endpoint, but no response schema is documented. The probe only tested HEAD/GET (returning 404), while the endpoint is POST-only, so liveness is not confirmed but strongly implied. No crawled documentation was available beyond the OpenAPI manifest.
Warnings
- —Probe did not confirm a 402 challenge because it tested HEAD/GET; the endpoint is POST-only per the OpenAPI spec.
- —No response schema is documented — the shape of the returned video object is unknown from this source alone.
- —Crawled pages all returned 404; supplementary docs at docs.diffbot.com and beta.paywithlocus.com/mpp/diffbot.md were not fetched.
Citations
- —The video endpoint accepts POST with a required url parameter and optional fields, timeout, and discussion parameters.https://diffbot.mpp.paywithlocus.com
- —Each call costs 4200 base units of pathUSD (currency 0x20c000000000000000000000b9537d11c60e8b50) settled via Tempo.https://diffbot.mpp.paywithlocus.com
- —The Diffbot MPP gateway also exposes article, product, discussion, image, analyze, event, list, and job endpoints.https://diffbot.mpp.paywithlocus.com
- —API reference documentation is available at docs.diffbot.com.https://diffbot.mpp.paywithlocus.com