Rate Limits & Credits

Rate Limits

The Bitparse API enforces a rate limit to ensure fair usage across all users.

When you exceed the rate limit, the API returns 429 Too Many Requests:

{
  "error": "rate limit exceeded"
}

Wait at least 1 second before sending the next request.

Handling Rate Limits in Code

import time
import requests

files_to_parse = ["doc1.pdf", "doc2.pdf", "doc3.pdf"]

for file_path in files_to_parse:
    resp = requests.post(
        "https://api.bitparse.ai/parse",
        headers={"X-API-Key": "bp_YOUR_API_KEY"},
        files={"file": open(file_path, "rb")},
    )

    if resp.status_code == 429:
        time.sleep(1)
        resp = requests.post(
            "https://api.bitparse.ai/parse",
            headers={"X-API-Key": "bp_YOUR_API_KEY"},
            files={"file": open(file_path, "rb")},
        )

    print(resp.json())
    time.sleep(1)  # proactive delay between requests

Credits

Bitparse uses a credit-based system. 1 credit = 1 page processed.

• A single-page PDF or image costs 1 credit.
• A 10-page PDF costs 10 credits.
• Credits are deducted after successful processing.

If you do not have enough credits, the API returns 402 Payment Required before any processing occurs.

Checking Your Balance

Your remaining credits are included in every successful response:

{
  "credits_used": 5,
  "credits_remaining": 495
}

Use this to monitor usage programmatically.

Pricing

Standard Plans

Custom Volume

For higher volumes, credits are available at $0.008 per credit in quantities from 3,000 to 25,000.

Purchase credits in the Dashboard or contact sales@bitparse.ai for custom arrangements.

FAQ

Do credits expire? No. Credits remain on your account until used.

What happens if I run out mid-document? The API checks your balance before processing. If you don't have enough credits for the full document, the request is rejected with a 402 error and no credits are deducted.

Can I get a refund for failed processing? Credits are only deducted on successful processing. If the API returns a 500 error, no credits are charged.