Extract structured image data from any web page via Diffbot's Image API, paid per call over MPP.
What it does
This endpoint wraps Diffbot's Image extraction API behind the Locus MPP (Micropayment Protocol) gateway. You POST a JSON body containing the URL of a page with images, and Diffbot returns structured data about the images found on that page — dimensions, captions, source URLs, alt text, and other metadata. The endpoint settles payments via the Tempo method on pathUSD at $0.0042 per call.
The Image endpoint is one of several Diffbot extraction APIs available through this same MPP gateway (others include Article, Product, Discussion, Video, Analyze, Event, List, and Job Posting — each at the same per-call price). Optional parameters let you request extra fields, set a timeout, or toggle discussion/comment extraction. The endpoint accepts POST requests with an `application/json` body; the only required field is `url`.
Note that the probe did not receive a 402 challenge when hitting the image endpoint with HEAD/GET — the endpoint is POST-only, which explains the 404 on those methods. The OpenAPI spec clearly defines the POST route and its payment info, so the endpoint is presumed live. No response schema or example responses are documented, so the exact shape of returned image data must be inferred from Diffbot's public documentation.
Capabilities
Use cases
- —Extracting all images and their metadata (dimensions, captions, alt text) from a given web page
- —Building image datasets by scraping structured image information from URLs at scale
- —Enriching content pipelines with image metadata for downstream indexing or analysis
- —Agents that need to understand what images appear on a page without rendering it
Fit
Best for
- —AI agents needing structured image data from arbitrary URLs without managing API keys
- —Pay-per-call image extraction without a Diffbot subscription
- —Automated web scraping pipelines that need image metadata in JSON
Not for
- —Downloading or hosting the actual image binary files
- —Computer vision tasks like object detection or classification on image content
- —High-volume bulk crawling where a direct Diffbot subscription would be more cost-effective
Quick start
curl -X POST https://diffbot.mpp.paywithlocus.com/diffbot/image \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <MPP_TOKEN>" \
-d '{"url": "https://example.com/gallery"}'Example
Request
{
"url": "https://example.com/gallery",
"fields": "links,meta",
"timeout": 30000
}Endpoint
Quality
The OpenAPI spec provides a clear request schema and payment info for the image endpoint, but no response schema or example responses are documented. The probe returned 404 on HEAD/GET, which is expected for a POST-only route, but means we lack a confirmed 402 challenge. Crawled pages returned only generic 'not found' messages. Pricing and request format are well-defined; response shape must be inferred from external Diffbot docs.
Warnings
- —No 402 challenge was captured — endpoint only accepts POST, so liveness is inferred from the OpenAPI spec rather than confirmed
- —No response schema documented; callers must consult Diffbot's own docs for the shape of returned image data
- —Currency address 0x20c000000000000000000000b9537d11c60e8b50 is assumed to be pathUSD with 6 decimals based on the Tempo method context
Citations
- —The endpoint charges 4200 base units via Tempo method with the listed currency address per callhttps://diffbot.mpp.paywithlocus.com
- —The request body requires a 'url' field and optionally accepts 'fields', 'timeout', and 'discussion' parametershttps://diffbot.mpp.paywithlocus.com
- —Diffbot provides web data extraction for articles, products, discussions, images, videos, and auto-detecthttps://www.diffbot.com
- —API reference documentation is available at docs.diffbot.comhttps://docs.diffbot.com
- —LLM-oriented docs for this MPP integration are at beta.paywithlocus.com/mpp/diffbot.mdhttps://beta.paywithlocus.com/mpp/diffbot.md