{"uid":"cap_ZJZ8KUDwgb9xBWWB9YpFz","slug":"diffbot-list-96b2b07f","name":"Diffbot List Extractor","description":"Extract structured items from listing pages — product listings, search results, news indexes.","url":"https://diffbot.mpp.paywithlocus.com/diffbot/list?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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},"responseSchema":null,"example":{"request":{"url":"https://en.wikipedia.org/wiki/List_of_countries_by_population","fields":"links,meta","timeout":30000},"response":{"_truncated":true,"_originalSize":106191}},"exampleRequest":{"url":"https://en.wikipedia.org/wiki/List_of_countries_by_population","fields":"links,meta","timeout":30000},"tags":["web-scraping","extraction","articles","products","web","data"],"displayCostAmount":"0.0042","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.08","successRate":"1.00","reviews":1,"stars":"1.3","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0042/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.0042","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.0042","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0c7uGLuIPcWTcW6p2COIq","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.0042","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"Diffbot","brandSlug":"diffbot","brandBaseUrl":"https://www.diffbot.com","brandDocsUrl":"https://docs.diffbot.com","whatItDoes":"Extracts structured item listings from a URL pointing to a list/directory page, returning the items and optional metadata","exampleAgentPrompt":"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?","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-07-17T19:00:57.332Z","lastSuccessfullyRanAt":"2026-07-17T19:00:57.332Z","lastHealthCheckAt":"2026-10-10T00:32:42.766Z","isFirstParty":false,"canonicalSlug":"diffbot-list-96b2b07f"}