The Data Extraction API charges credits per page processed. The cost depends on the processing mode.
| Mode | Cost per page | Description |
|---|---|---|
text | 1 credit | Fast Markdown extraction via Document Engine. No OCR or AI. |
structure | 1.5 credits | OCR-based structured extraction with spatial element output |
understand | 9 credits | Full extraction pipeline with AI-augmented layout analysis |
agentic | 18 credits | VLM-augmented extraction for complex documents |
For example, processing a 10-page PDF in structure mode costs 15 credits. The same document in text mode costs 10 credits and 90 credits in understand mode.
FAQs
Below are common questions about credits, modes, rate limits, and what happens when you run out.
How do credits work?
Each API request consumes credits based on the number of pages processed and the mode used. The response includes a usage field showing the credits consumed and the remaining balance:
{ "usage": { "data_extraction_credits": { "cost": 9, "remainingCredits": 850 } }}Which mode should I choose?
Use text mode for high-throughput Markdown pipelines where you only need text content. Use structure mode when you need spatial element data (bounding boxes, table cells, key-value pairs) at moderate cost. Use understand mode for complex documents with tables, forms, and multicolumn layouts, or when you need the highest extraction accuracy. Use agentic mode for the most complex documents that benefit from VLM-augmented visual understanding (18 credits per page). Refer to processing modes for a detailed comparison.
How do I check my remaining credits?
Every API response includes a usage field with your remaining credit balance. You can also check your balance in the Data Extraction API dashboard(opens in a new tab).
What happens when I run out of credits?
Requests return a 402 status code with a message indicating insufficient credits. Purchase additional credits through the dashboard.
Is there a rate limit?
Yes. Rate limits depend on your subscription plan. Requests exceeding the limit receive a 429 status code. Contact the Sales team for higher rate limits.