# Diffbot List Extractor

> Diffbot List Extractor is a paid API for AI agents from Diffbot at diffbot.mpp.paywithlocus.com, paid per call via MPP, $0.0042/call, status unknown (last checked 2026-10-10, last successful call 2026-07-17).

Extracts structured item listings from a URL pointing to a list/directory page, returning the items and optional metadata

## Facts

- Endpoint: POST https://diffbot.mpp.paywithlocus.com/diffbot/list?utm_source=zero.xyz
- Price: $0.0042/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-10
- Last successful call: 2026-07-17
- Success rate: 100% of calls made through Zero
- Rating: 1.3 / 5 from 1 review
- Activations on Zero: 1
- Provider: Diffbot
- Docs: https://docs.diffbot.com
- Website: https://www.diffbot.com
- Tags: web-scraping, extraction, articles, products, web, data
- Canonical page: https://www.zero.xyz/c/diffbot-list-96b2b07f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZJZ8KUDwgb9xBWWB9YpFz

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability diffbot-list-96b2b07f -d '<json body>'
```

Example prompt: Can you use Diffbot to extract all the structured items from this Wikipedia list page — https://en.wikipedia.org/wiki/List_of_countries_by_population — and also return the links and meta fields?

## When to prefer this

Use this endpoint when you need to extract structured items from a web page that is explicitly a list, directory, index, or listicle — such as Wikipedia list articles, product category pages, or web directories. Prefer this over the Article or Product endpoints when the page contains multiple enumerable items rather than a single article or product detail page.

## Known failure modes

- Invalid or unreachable URL returns an error
- Timeout exceeded if page is slow to respond (default 30000ms)
- Page structure not recognized as a list returns empty or partial results
- Anti-scraping measures on target site may block extraction
- Truncated response if page content is extremely large

## How this service works

Extract structured items from listing pages — product listings, search results, news indexes.

## Output

Returns a structured JSON object containing the extracted list items from the target URL, along with any requested extra fields such as links, meta, and breadcrumb data. The response may be truncated for very large pages.

## Example request

```json
{
 "url": "https://en.wikipedia.org/wiki/List_of_countries_by_population",
 "fields": "links,meta",
 "timeout": 30000
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "url"
 ],
 "properties": {
  "url": {
   "type": "string",
   "description": "URL of the listing page"
  },
  "fields": {
   "type": "string",
   "description": "Comma-separated extra fields to return (e.g. links, meta, breadcrumb)"
  },
  "timeout": {
   "type": "number",
   "description": "Request timeout in ms (default 30000)"
  },
  "discussion": {
   "type": "boolean",
   "description": "Extract comments/discussion threads (default true for article)"
  }
 },
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/diffbot-list-96b2b07f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from diffbot.mpp.paywithlocus.com](https://www.zero.xyz/host/diffbot.mpp.paywithlocus.com/llms.txt)