{"uid":"cap_y8MF1zw11CNLcpiLJ_h_x","slug":"fetchwerk-structured-web-extraction-649c34d2","name":"fetchwerk Structured Web Extraction","description":"Fill a caller supplied JSON Schema from one web page and report source and confidence for every field.","url":"https://fetch.netzhandwerker.de/structured?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Absolute http or https URL to read."},"schema":{"type":"object","description":"Target JSON Schema, draft 2020-12. Only the types object, array, string, number, integer, boolean and null are accepted; composition keywords such as $ref, oneOf, anyOf, allOf and if/then are refused. At most 200 fields and no deeper than max_depth. The root must describe an object."},"strict":{"type":"boolean","default":true,"description":"true rejects the call with 422 when the result violates the submitted schema, so no partial data is returned and nothing is charged. false returns the partial data with the error list."},"max_depth":{"type":"integer","default":3,"maximum":4,"minimum":1,"description":"Maximum nesting depth the submitted schema may use. A deeper schema is refused before payment."}}},"responseSchema":{"type":"json","example":{"url":"https://example.com/product","data":{"name":"Example widget","price":19.9},"charged":true,"confidence":{"name":1,"price":1},"validation":{"valid":true,"errors":[]},"field_sources":{"name":"jsonld","price":"jsonld"},"unavailable_fields":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dOH7Ysm0iBs90G8Io9IwQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a single web page and fills a caller-supplied JSON Schema with extracted data, reporting source and confidence for every field.","exampleAgentPrompt":"Fetch the page at https://example.com/product/123 and extract the data into this schema: {\"type\":\"object\",\"properties\":{\"title\":{\"type\":\"string\"},\"price\":{\"type\":\"number\"},\"inStock\":{\"type\":\"boolean\"}}}, using strict mode so I only get back data that fully matches.","exampleUseCases":[{"title":"Competitor pricing intelligence","prompt":"Go to https://www.competitorsite.com/pricing and pull out the plan names, monthly prices, and feature lists into this schema: {\"type\":\"object\",\"properties\":{\"plans\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\"},\"price\":{\"type\":\"number\"},\"features\":{\"type\":\"array\",\"items\":{\"type\":\"string\"}}}}}}}, and use strict mode so I only get confirmed data."},{"title":"News article structured extraction","prompt":"Fetch https://techcrunch.com/2024/05/01/some-article and extract the author name, publication date, headline, and article summary into this schema: {\"type\":\"object\",\"properties\":{\"author\":{\"type\":\"string\"},\"published\":{\"type\":\"string\"},\"headline\":{\"type\":\"string\"},\"summary\":{\"type\":\"string\"}}}, with strict mode off so I still get partial results if something is missing."},{"title":"Job listing data extraction","prompt":"Visit https://jobs.example.com/listing/456 and fill this schema with the job title, company name, location, salary range, and required skills: {\"type\":\"object\",\"properties\":{\"title\":{\"type\":\"string\"},\"company\":{\"type\":\"string\"},\"location\":{\"type\":\"string\"},\"salaryMin\":{\"type\":\"number\"},\"salaryMax\":{\"type\":\"number\"},\"skills\":{\"type\":\"array\",\"items\":{\"type\":\"string\"}}}}, and tell me the confidence score for each field."}],"resultDescription":"A JSON object whose shape matches the submitted schema, with each field populated from the fetched web page. Each field is annotated with a source reference (e.g. CSS selector or text position) and a confidence score between 0 and 1. In strict mode, a 422 error with a validation error list is returned (and no charge applied) if the result violates the schema; in non-strict mode, partial data is returned alongside the error list.","failureModes":["422 Unprocessable Entity if strict mode is enabled and extracted data violates the schema — no charge applied","422 if the submitted schema uses forbidden composition keywords ($ref, oneOf, anyOf, allOf, if/then) or exceeds 200 fields or max_depth","404 or fetch error if the target URL is unreachable or returns a non-200 response","Partial data with errors list when strict=false and the page content does not fully satisfy the schema","Timeout if the target page is slow to load or behind a login wall","Low confidence scores if the page content is sparse, heavily JavaScript-rendered, or obfuscated"],"whenToPreferThis":"Choose this endpoint when you have a precise, caller-defined schema and need both extracted values and per-field provenance (source + confidence). It is ideal when schema validation matters — strict mode prevents partial data from silently passing through. Prefer it over generic scrapers when you need typed, validated output rather than raw HTML or Markdown. If you only need article text or page metadata, sibling endpoints for Markdown extraction or metadata extraction are more appropriate.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:43:02.077Z","isFirstParty":false,"canonicalSlug":"fetchwerk-structured-web-extraction-649c34d2"}