{"uid":"cap_iiYzyNlkpVuMcN0q5h9Td","slug":"diffbot-list-extraction-via-locus-x402-577e4f82","name":"Diffbot List Extraction via Locus x402","description":"Web data extraction — articles, products, discussions, images, videos, and auto-detect.","url":"https://diffbot.x402.paywithlocus.com/diffbot/list","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string"},"fields":{"type":"string"},"timeout":{"type":"number"},"discussion":{"type":"boolean"}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0042","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0042/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0042","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0042","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QW_xWLp3gHxkfU-ipxHc4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0042","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Extracts structured data from a listing/index web page URL using Diffbot, returning parsed entities like products, articles, or items found on the page.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"E-commerce catalog page scraping","prompt":"Pull all the products listed on this category page https://www.bestbuy.com/site/laptops and give me the structured data including breadcrumbs and any metadata."},{"title":"Blog index article extraction","prompt":"Extract the list of articles from this blog index page https://techcrunch.com/category/startups — I want structured data including titles, links, and any author info available."},{"title":"Directory or marketplace listing scrape","prompt":"Scrape the listing page at https://www.yelp.com/search?find_desc=restaurants&find_loc=NYC and return the structured data for all the businesses shown, including their links."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:40:46.534Z","isFirstParty":false}