{"uid":"cap_vJH0sNLGF47q1mPLowVSi","slug":"agent-souk-structured-data-extraction-api-0ad7db29","name":"Agent Souk Structured Data Extraction API","description":"Extract structured JSON from text according to your JSON Schema (LLM) (1 × 10,000 characters at 0.030000 USDC each)","url":"https://api.agentsouk.dev/v1/x402/lst_01M1YBDYQJ02BVD0N6H73A6RCM","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"text":{"type":"string","maxLength":50000,"minLength":1},"schema":{"type":"object","description":"A JSON Schema (draft-07, 2019-09 or 2020-12) with type \"object\" at the root"},"instructions":{"type":"string","maxLength":1000,"description":"Optional extraction hints, e.g. \"amounts in EUR as numbers\""}}},"responseSchema":{"type":"json","example":{"data":{"date":"2026-09-01","total":1250,"vendor":"Acme GmbH","currency":"EUR","contact_email":"billing@acme.example","invoice_number":"4711"},"chars":118,"model":"claude-opus-5","schema_valid":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DOF8x636R0ZFH_YZqFmnM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Extracts structured JSON data from arbitrary text using a caller-supplied JSON Schema, powered by an LLM backend","exampleAgentPrompt":"Extract the invoice date, total amount, vendor name, currency, contact email, and invoice number from this text: 'Invoice #4711 from Acme GmbH dated 2026-09-01. Total: EUR 1,250. Contact: billing@acme.example' — return them as structured JSON with amounts as numbers.","exampleUseCases":[{"title":"Invoice data extraction pipeline","prompt":"Pull the invoice number, vendor, date, total, and currency from this invoice text and return it as structured JSON — amounts should be plain numbers, not strings: 'Invoice #INV-2024-0088 issued by TechSupplies Ltd on 2024-03-15. Amount due: USD 4,320.00. Remit to: accounts@techsupplies.com'"},{"title":"Contract clause extraction for legal review","prompt":"Extract the parties involved, effective date, termination clause, and governing law from this contract excerpt and return them as structured JSON: 'This Agreement is entered into on January 1, 2025 between Alpha Corp and Beta LLC... governed by the laws of the State of New York... either party may terminate with 30 days written notice.'"},{"title":"Customer feedback form parsing","prompt":"Parse this raw customer support email into structured JSON with fields for customer name, issue category, severity (low/medium/high), and a one-sentence summary: 'Hi, I'm Jane Doe and I've been unable to log in for 3 days — this is blocking my whole team and needs urgent attention. Order ref: ORD-9921.'"}],"resultDescription":"A JSON object containing a 'data' field with all extracted fields conforming to the provided schema, plus metadata: 'chars' (input character count), 'model' (LLM used, e.g. claude-opus-5), and 'schema_valid' (boolean indicating whether the output passed schema validation).","failureModes":["Text too short or empty — minLength:1 enforced, returns 400","Text exceeds 50,000 character limit — returns 400 or truncation error","Schema is invalid or not a JSON Schema draft-07/2019-09/2020-12 object — returns 400","LLM cannot reliably extract requested fields from ambiguous text — schema_valid may be false","Payment failure via x402 (insufficient USDC balance) — returns 402","Network timeout if text is very long and model is slow — returns 504"],"whenToPreferThis":"Choose this endpoint when you need to convert unstructured or semi-structured text into a precisely defined JSON shape in a single API call, especially when the target schema varies per request. It is ideal for document processing pipelines (invoices, contracts, emails) where you control the output schema and need schema validation confirmation. Prefer this over generic LLM completions when you need guaranteed JSON structure with schema conformance checking, and over dedicated parsers when the document format is variable or unpredictable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:42:12.732Z","isFirstParty":false}