# Extract.FAST API

Build file extraction workflows with the same single-job shape used across Tools.FAST APIs: estimate credits, submit one file with options, poll the job, then download the result.

## Base URL

`https://api.tools.fast/extract`

## Public API shape

- `POST /estimate/{sourceFileExtension}` estimates one file and one option payload without uploading the file.
- `POST /extract` submits one extraction job and can include transcript as a priced add-on for audio and video files.
- `POST /transcribe` submits a transcript-only audio or video job.
- `GET /job/{id}` polls status.
- `GET /job/{id}/download` downloads the finished ZIP.
- `POST /job/{id}/cancel` cancels queued or running work when possible.
- `DELETE /job/{id}` deletes the job record and stored artifacts when allowed.
- `GET /entitlements/me` returns the caller's usable credits and plan limits.

## What Extract returns

Extraction results download as a ZIP. The ZIP can contain images, text, markdown, PDF pages, slide renders, worksheets, audio tracks, video frames, subtitles, metadata, transcripts, and a file summary depending on the source format and selected options.

## Versioning

The current public contract is `v1` by convention. New response fields may be added without a version bump. Existing fields, stable error codes, and route meanings are treated as compatibility commitments.
