# AIDataParser

> A credit-based data-extraction API built for AI agents. POST a PDF or image
> (URL, base64, or multipart) with an optional JSON Schema and get clean,
> structured JSON back — with a confidence score and a review-needed flag.

AIDataParser is the parsing tool your AI agent calls when it hits messy data.
It is schema-first: pass the JSON Schema you want and the response is guaranteed
to match it. Pricing is by the credit (50 free on signup, no card); roughly one
credit per document.

## Getting started

- Issue an API key: `POST https://aidataparser.com/v1/keys` with `{"email":"you@example.com"}` (returns 50 free credits).
- Authenticate with `Authorization: Bearer adp_live_...`.

## Endpoints

- [Parse a document](https://aidataparser.com/v1/parse/document): POST a PDF or image (`url`, `base64`+`media_type`, or multipart `file`) with optional `schema` and `instructions`. Returns `{ data, confidence, review_needed, notes, credits_remaining }`.
- [Issue an API key](https://aidataparser.com/v1/keys): POST `{ email }` to create an account and receive a key with 50 free credits.

## Docs

- [API reference](https://aidataparser.com/docs): quickstart, auth, request/response fields, and error codes.
- [OpenAPI spec](https://aidataparser.com/openapi.json): machine-readable OpenAPI 3.1 definition.

## Notes for agents

- Supported inputs: application/pdf, image/png, image/jpeg, image/gif, image/webp.
- Text-first PDFs are parsed directly; scanned/image-only PDFs should be sent as images.
- Always inspect `review_needed` before trusting an extraction in an automated pipeline.