# Diffbot List Extraction via Locus x402

> Diffbot List Extraction via Locus x402 is a paid API for AI agents from diffbot.x402.paywithlocus.com, paid per call via x402, $0.0042/call, status unknown (last checked 2026-09-14).

Extracts structured data from a listing/index web page URL using Diffbot, returning parsed entities like products, articles, or items found on the page.

## Facts

- Endpoint: POST https://diffbot.x402.paywithlocus.com/diffbot/list
- Price: $0.0042/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/diffbot-list-extraction-via-locus-x402-577e4f82
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iiYzyNlkpVuMcN0q5h9Td

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-extraction-via-locus-x402-577e4f82 -d '<json body>'
```

Example prompt: Can you extract the structured list of items from this e-commerce category page — https://www.example.com/shop/laptops — and include the breadcrumb and links fields too?

## When to prefer this

Choose this endpoint when you need to extract structured data specifically from a web page that is a listing, catalog, index, or directory — where multiple items are enumerated. It is backed by Diffbot's specialized list parser, making it more accurate than generic scrapers for paginated or multi-item pages. Prefer it over generic article or product extractors when the target URL contains a collection of items rather than a single content piece.

## Known failure modes

- Invalid or inaccessible URL returns extraction error or empty data
- Timeout exceeded if page is slow to load (default 30000ms)
- Non-listing page type may return unexpected or sparse structured data
- Payment failure or insufficient USDC balance blocks the request
- Requested extra fields not available on page return empty values

## How this service works

Web data extraction — articles, products, discussions, images, videos, and auto-detect.

## Output

A JSON response containing a 'data' object with structured entities extracted from the listing page (items, products, articles, or other listed content), along with payment settlement info (settled USDC amount) and a request ID with a status URL for tracking.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string"
  },
  "fields": {
   "type": "string"
  },
  "timeout": {
   "type": "number"
  },
  "discussion": {
   "type": "boolean"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "payment": {
   "scheme": "exact",
   "settledUsdc": "0.001000",
   "authorizedMaxUsdc": "0.001000"
  },
  "request": {
   "id": "00000000-0000-4000-8000-000000000000",
   "statusUrl": "/requests/00000000-0000-4000-8000-000000000000"
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/diffbot-list-extraction-via-locus-x402-577e4f82/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from diffbot.x402.paywithlocus.com](https://www.zero.xyz/host/diffbot.x402.paywithlocus.com/llms.txt)