Diffbot Natural Language API via MPP — NER, sentiment, facts, and summarization per call.
What it does
This endpoint exposes Diffbot's Natural Language Processing API through the Locus MPP (Micropayment Protocol), settling payments on Tempo L2 in pathUSD. It accepts text content and returns structured NLP results including named entity recognition (NER), sentiment analysis, fact extraction, categorization, sentence segmentation, summarization, and language detection.
The endpoint is a POST at `/diffbot-nl/analyze`. You send a JSON body with a `content` field (a plain text string or an array of document objects with optional `lang` and `format` keys) and an optional `fields` parameter — a comma-separated list selecting which NLP outputs you want (e.g. `entities,sentiment,summary`). Pricing is listed as $0.004+ per 10,000 characters, charged per request via the MPP "charge" intent.
Note: The probe only tested HEAD and GET methods, both of which returned 404. Since the OpenAPI spec declares this as a POST-only endpoint, the 404s on HEAD/GET do not indicate the endpoint is down — they simply reflect that the endpoint is not routed for those methods. The crawl of the provider origin and auxiliary paths all return generic "not found" JSON, which is normal for an MPP gateway that only serves its declared API paths. Upstream Diffbot documentation is available at https://docs.diffbot.com/reference/natural-language and an LLM-friendly skill file at https://beta.paywithlocus.com/mpp/diffbot-nl.md.
Capabilities
Use cases
- —Extract named entities (people, organizations, locations) from unstructured text
- —Run sentiment analysis on customer reviews or social media posts
- —Generate concise summaries of long-form articles or documents
- —Extract structured facts and relationships from news articles
- —Detect the language of incoming text before further processing
Fit
Best for
- —Agents needing on-demand NLP without managing API keys or subscriptions
- —Pay-per-use text analysis at sub-cent granularity
- —Combining multiple NLP tasks (NER + sentiment + summary) in a single call
Not for
- —High-volume batch processing where a direct Diffbot subscription would be cheaper
- —Real-time streaming text analysis (this is a synchronous per-call endpoint)
- —Image, audio, or non-text content analysis
Quick start
curl -X POST https://diffbot-nl.mpp.paywithlocus.com/diffbot-nl/analyze \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <MPP_TOKEN>" \
-d '{"content": "Apple Inc. reported record revenue in Cupertino on Tuesday.", "fields": "entities,sentiment,summary"}'Example
Request
{
"fields": "entities,sentiment,summary",
"content": "Apple Inc. reported record revenue in Cupertino on Tuesday."
}Endpoint
Quality
The OpenAPI spec provides a clear request schema, pricing description, and endpoint summary, but no response schema or examples are available. The probe only tested HEAD/GET (both 404), so liveness via POST is not directly confirmed. No crawled pages returned useful documentation. Pricing and capabilities are inferred from the OpenAPI metadata and existing listing description.
Warnings
- —Endpoint liveness not directly confirmed — probe used HEAD/GET which returned 404; the endpoint is POST-only per the OpenAPI spec
- —No response schema or example response available in the probe or crawl data
- —Crawled pages (root, /docs, /api, /pricing, /README) all return generic 'not found' JSON — no supplementary documentation was retrievable
- —Price description says '$0.004+ per 10k chars' but the OpenAPI amount field is null, so exact per-request cost may vary
Citations
- —Endpoint supports NER, sentiment, facts, categorization, sentences, summary, and language detection fieldshttps://diffbot-nl.mpp.paywithlocus.com
- —Pricing is $0.004+ per 10,000 characters, settled via Tempo in pathUSDhttps://diffbot-nl.mpp.paywithlocus.com
- —Upstream API reference available at Diffbot docshttps://docs.diffbot.com/reference/natural-language
- —LLM-friendly skill file for this MPP endpointhttps://beta.paywithlocus.com/mpp/diffbot-nl.md