# Extract from HEIF

Use this extractor for `.heif` files. It can extract EXIF data, GPS data & map, QR codes and barcodes, color palette, ICC profiles, text into a ZIP result.

## Quick reference

| Field | Value |
| --- | --- |
| Source file type | `.heif` |
| Source group | Images |
| Submit endpoint | `POST https://api.tools.fast/extract` |
| Estimate endpoint | `POST https://api.tools.fast/extract/estimate/heif` |
| Result | ZIP download |
| Default capabilities | `image.exif`, `image.gps`, `image.codes`, `image.colors`, `image.profiles`, `image.text` |
| Max file size | free: 50 MB; pro: 2048 MB |
| Document limits | Not applicable |
| Duration limits | Not applicable |

## Capabilities

| Capability | Default | Options | Pricing | Description |
| --- | --- | --- | --- | --- |
| `image.exif` | Yes | None | Included | EXIF-style metadata exported as JSON and CSV. |
| `image.gps` | Yes | None | Included | GPS coordinates plus a downloadable map when stored in the source file. |
| `image.codes` | Yes | None | Included | QR codes and barcodes found in the file. |
| `image.colors` | Yes | None | Included | Dominant colors and palette information. |
| `image.profiles` | Yes | None | Included | ICC profiles and color management data. |
| `image.text` | Yes | None | Included | Text recognized from screenshots, photos, and scanned images with Fast AI OCR. |

## Options payload with all capabilities

Use this shape when you want to explicitly configure every supported output for this source type.

```json
{
  "extraction": {
    "selectedCapabilities": [
      "image.exif",
      "image.gps",
      "image.codes",
      "image.colors",
      "image.profiles",
      "image.text"
    ],
    "includeManifest": true
  }
}
```

## Estimate example

```bash
curl -sS -X POST "https://api.tools.fast/extract/estimate/heif" \
  -H "X-Fast-Api-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "fileSizeMb": 10,
  "options": {
    "extraction": {
      "selectedCapabilities": [
        "image.exif",
        "image.gps",
        "image.codes",
        "image.colors",
        "image.profiles",
        "image.text"
      ],
      "includeManifest": true
    }
  }
}'
```

## Extract example with all options configured

```bash
curl -sS -X POST "https://api.tools.fast/extract" \
  -H "X-Fast-Api-Key: $API_KEY" \
  -F "file=@input.heif" \
  -F 'options={
  "extraction": {
    "selectedCapabilities": [
      "image.exif",
      "image.gps",
      "image.codes",
      "image.colors",
      "image.profiles",
      "image.text"
    ],
    "includeManifest": true
  }
}'
```

## Machine-readable discovery

```http
GET /options/heif
GET /extractors/heif
```