{"uid":"cap_nNmLVFQuEUoroojleSFeA","slug":"jigsawstack-withzero-ai-vocr-3a72ff46","name":"JigsawStack Vision OCR + Prompt-Driven Extraction","description":"Vision OCR + optional prompt-driven extraction from a hosted image URL.","url":"https://jigsawstack.withzero.ai/v1/vocr","method":"POST","headers":{},"bodySchema":{"type":"object","oneOf":[{"required":["url"]},{"required":["file_store_key"]}],"properties":{"url":{"type":"string","description":"Publicly hosted image URL to perform OCR on. Mutually exclusive with file_store_key."},"prompt":{"type":"string","description":"Optional natural language prompt for structured/targeted data extraction from the image."},"file_store_key":{"type":"string","description":"A file store key referencing a previously uploaded image. Mutually exclusive with url."}},"additionalProperties":false},"responseSchema":{"type":"object","required":["success","width","height","tags","has_text","sections","_usage","log_id"],"properties":{"tags":{"type":"array","items":{"type":"string"}},"width":{"type":"number"},"_usage":{"type":"object","required":["input_tokens","output_tokens","inference_time_tokens","total_tokens"],"properties":{"input_tokens":{"type":"number"},"total_tokens":{"type":"number"},"output_tokens":{"type":"number"},"inference_time_tokens":{"type":"number"}}},"height":{"type":"number"},"log_id":{"type":"string"},"success":{"type":"boolean"},"has_text":{"type":"boolean"},"sections":{"type":"array","items":{"type":"object","required":["text","lines"],"properties":{"text":{"type":"string"},"lines":{"type":"array","items":{"type":"object","required":["text","bounds","average_confidence","words"],"properties":{"text":{"type":"string"},"words":{"type":"array","items":{"type":"object","required":["text","bounds","confidence"],"properties":{"text":{"type":"string"},"bounds":{"type":"object"},"confidence":{"type":"number"}}}},"bounds":{"type":"object","required":["top_left","top_right","bottom_right","bottom_left","width","height"],"properties":{"width":{"type":"number"},"height":{"type":"number"},"top_left":{"type":"object","required":["x","y"],"properties":{"x":{"type":"number"},"y":{"type":"number"}}},"top_right":{"type":"object","required":["x","y"],"properties":{"x":{"type":"number"},"y":{"type":"number"}}},"bottom_left":{"type":"object","required":["x","y"],"properties":{"x":{"type":"number"},"y":{"type":"number"}}},"bottom_right":{"type":"object","required":["x","y"],"properties":{"x":{"type":"number"},"y":{"type":"number"}}}}},"average_confidence":{"type":"number"}}}}}}}}},"example":{"request":{"url":"https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png"},"response":{"tags":["screenshot","white"],"width":544,"_usage":{"input_tokens":16,"total_tokens":419,"output_tokens":88,"inference_time_tokens":315},"height":184,"log_id":"24715ca4-4933-40e5-a388-129d3e68ebcf","success":true,"has_text":true,"sections":[{"text":"Google","lines":[{"text":"Google","words":[{"text":"Google","bounds":{"width":537,"height":164,"top_left":{"x":0,"y":0},"top_right":{"x":537,"y":15},"bottom_left":{"x":0,"y":171},"bottom_right":{"x":537,"y":172}},"confidence":0.99}],"bounds":{"width":556.5,"height":164.5,"top_left":{"x":0,"y":0},"top_right":{"x":557,"y":11},"bottom_left":{"x":0,"y":168},"bottom_right":{"x":556,"y":172}},"average_confidence":0.99}]}]}},"exampleRequest":{"url":"https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png"},"tags":[],"displayCostAmount":"0.005000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.25","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005000/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uzCqPNlGMfS84wWV2NA-m","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"jigsawstack.withzero.ai","brandSlug":"jigsawstack-withzero-ai-mpp","brandBaseUrl":"https://jigsawstack.withzero.ai","brandDocsUrl":null,"whatItDoes":"Performs OCR on a hosted image URL and optionally extracts structured data from it using a natural language prompt","exampleAgentPrompt":"Read all the text from this invoice image and extract the vendor name, total amount, and due date: https://storage.example.com/invoices/inv-2024-0523.jpg","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the raw OCR text found in the image and, if a prompt was provided, structured extracted fields corresponding to the prompt instructions (e.g. named values, tables, or key-value pairs parsed from the image content).","failureModes":["Image URL is inaccessible or returns a non-200 response — extraction fails with an error","Image format is unsupported or corrupt — returns an error or empty result","Image has no readable text — returns empty OCR output","Prompt is too vague or mismatched to image content — structured extraction may be incomplete or inaccurate","Image file exceeds size limits — request rejected","Network timeout fetching the remote image URL"],"whenToPreferThis":"Choose this endpoint when you need to extract text or structured data from an image hosted at a URL, especially when you want to combine raw OCR with prompt-driven field extraction in a single call. Ideal for processing invoices, receipts, scanned documents, screenshots, or any image containing text. Prefer this over generic OCR when you need both raw text and targeted field extraction in one step, settled via micro-USDC pay-per-call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":4,"lastUsedAt":"2026-04-28T23:48:16.106Z","lastSuccessfullyRanAt":"2026-04-28T23:48:16.106Z","lastHealthCheckAt":"2026-09-15T06:42:46.664Z","isFirstParty":true}