{"uid":"cap_OCQKJ6DH288b2_kq12dPG","slug":"soren-structured-text-extraction-97b42435","name":"Soren Structured Text Extraction","description":"Named fields pulled out of unstructured text as GUARANTEED-VALID JSON. POST the text as the raw body with fields=comma,separated,names (max 12). Every requested field is present in the answer — null when the text does not contain it — and the JSON is validated server-side BEFORE you are charged: no parse errors, no missing keys, ever. A failed inference costs nothing.","url":"https://soren.com/v1/ai/extract","method":"POST","headers":{},"bodySchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"queryParams":{"type":"object","required":["fields"],"properties":{"fields":{"type":"string","examples":["vendor,invoice_number,total,due_date"],"description":"Comma-separated field names to extract, max 12."}}}},"additionalProperties":false}}},"responseSchema":null,"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_zz9PrpWS6kmheERsoS6iY","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 named fields from unstructured text as guaranteed-valid JSON, with server-side validation ensuring no missing keys or parse errors","exampleAgentPrompt":"Extract the vendor name, invoice number, total amount, and due date from this invoice text: 'Invoice #4821 from Acme Corp dated March 3 2025, total due $1,240.00 by April 1 2025.' Return them as validated JSON with fields vendor,invoice_number,total,due_date.","exampleUseCases":[{"title":"Invoice data extraction for accounting","prompt":"I have this email body from a supplier: 'Please find attached invoice INV-9923 for $3,450 due by June 15, 2025 from GlobalParts Ltd.' Pull out the vendor, invoice_number, total, and due_date as structured JSON for me."},{"title":"Resume parsing for HR workflow","prompt":"Extract the candidate's name, email, phone, current_title, years_experience, and highest_degree from this resume text I'm pasting — I need it as clean JSON with every field guaranteed to be there."},{"title":"Contract clause extraction for legal review","prompt":"From this contract paragraph, pull out the governing_law, effective_date, party_a, party_b, and termination_notice fields — make sure the JSON is valid and any fields not mentioned come back as null."}],"resultDescription":"A validated JSON object containing every requested field name as a key. Fields found in the text carry their extracted string or numeric value; fields absent from the text are explicitly set to null. The response is guaranteed to have no missing keys and no JSON parse errors — invalid inferences are rejected server-side before billing.","failureModes":["More than 12 fields requested — request rejected","Text body is empty or missing — no extractable content","Fields query parameter omitted — 400 bad request","Inference fails server-side validation — no charge, but no result returned","Network timeout on large text inputs","Ambiguous field names may produce null even when data is present"],"whenToPreferThis":"Choose this endpoint when you need guaranteed-valid structured JSON from unstructured text and cannot tolerate missing keys or parse errors. It is ideal for agentic pipelines where downstream code depends on every field being present. The server-side validation guarantee and zero-cost failed inference make it safer than rolling your own LLM extraction prompt, especially for document processing workflows like invoice parsing, form extraction, or entity identification where correctness matters more than cost.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:42:40.605Z","isFirstParty":false}