Extract structured job posting data from any URL via Diffbot, paid per-call over MPP.
What it does
This endpoint wraps Diffbot's Job Posting extraction API behind the Locus MPP (Micropayment Protocol). Given a URL pointing to a job listing, it returns structured data about the posting — title, employer, location, salary, requirements, and other fields that Diffbot's AI-powered extraction engine can identify. Payment is handled per-call via the Tempo method on pathUSD at $0.0042 per request.
The endpoint is part of a broader Diffbot suite hosted on the same MPP gateway, which also exposes extraction for articles, products, discussions, images, videos, events, lists, and an auto-detect "analyze" mode. Each sub-endpoint shares the same pricing and request pattern: POST a JSON body with a required `url` field and optional parameters like `fields`, `timeout`, and `discussion`. The job endpoint specifically targets pages containing job postings (e.g., LinkedIn jobs, Indeed listings, company career pages).
The endpoint is served via Locus at `diffbot.mpp.paywithlocus.com` and settles payments in pathUSD on Tempo L2. The OpenAPI spec is well-defined with request schemas, though response schemas are not documented in the probe material. The probe's HEAD/GET attempts returned 404, which is expected since the endpoint only accepts POST requests. Diffbot's own documentation is available at docs.diffbot.com for detailed field descriptions and response formats.
Capabilities
Use cases
- —Extracting structured job posting data (title, company, salary, requirements) from arbitrary career page URLs
- —Building job aggregation pipelines that need clean structured data from diverse job boards
- —Monitoring competitor job postings for market intelligence
- —Enriching HR/recruiting workflows with parsed job listing metadata
- —Feeding job data into LLM-based agents that need structured employment information
Fit
Best for
- —Agents that need structured job posting data from arbitrary URLs without managing a Diffbot API key
- —Pay-per-call job extraction without subscription commitments
- —Programmatic job board scraping with structured JSON output
Not for
- —Bulk crawling thousands of job pages (per-call pricing adds up quickly)
- —Extracting non-job content — use sibling endpoints like /diffbot/article or /diffbot/product instead
- —Users who already have a Diffbot API subscription and don't need MPP payment rails
Quick start
curl -X POST https://diffbot.mpp.paywithlocus.com/diffbot/job \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/jobs/senior-engineer"}'Example
Request
{
"url": "https://example.com/careers/senior-software-engineer",
"fields": "links,meta",
"timeout": 30000,
"discussion": false
}Endpoint
Quality
The OpenAPI spec provides a clear request schema and pricing for this endpoint, but response schemas are absent. The probe returned 404 on HEAD/GET (expected for a POST-only endpoint), so liveness via the 402 challenge was not confirmed. No crawled pages yielded useful documentation beyond error messages pointing to external docs.
Warnings
- —Endpoint returned 404 on HEAD and GET probes; it likely only responds to POST, but a 402 challenge was not directly captured
- —Response schema is not documented in the OpenAPI spec — actual response fields must be inferred from Diffbot's own docs
- —Currency address 0x20c000000000000000000000b9537d11c60e8b50 is assumed to be pathUSD (6 decimals) based on the Tempo method; price shown as $0.0042 per call
Citations
- —The endpoint charges 4200 base units of pathUSD per call via Tempo settlementhttps://diffbot.mpp.paywithlocus.com
- —Diffbot API reference documentation is available at docs.diffbot.comhttps://docs.diffbot.com
- —The request body requires a url field and optionally accepts fields, timeout, and discussion parametershttps://diffbot.mpp.paywithlocus.com
- —The Locus MPP skill file and llms.txt are available at paywithlocus.comhttps://paywithlocus.com/skill.md