> ## Documentation Index
> Fetch the complete documentation index at: https://docs.axiomancer.io/llms.txt
> Use this file to discover all available pages before exploring further.

# ML Exports

> Two endpoints for ML-ready dataset metadata in Croissant and Hugging Face formats — for use with TensorFlow Datasets and other ML training pipelines.

## `GET` `/api/exports/croissant`

<Note>Requires Bearer token.</Note>

ML-ready dataset metadata in Croissant (schema.org/Dataset) format for use with TensorFlow Datasets, Hugging Face, and other ML frameworks.

**Query parameters**

| Name      | Type   | Required | Default | Description                                               |
| --------- | ------ | -------- | ------- | --------------------------------------------------------- |
| `dataset` | string | ✓        |         | Dataset name: scores, permits, pois, crime, demographics. |
| `metro`   | string |          |         | Metro slug filter.                                        |

**Example**

```bash theme={null}
curl "https://axiomlocus.io/api/exports/croissant?dataset=scores&metro=sf" \
  -H "Authorization: Bearer al_your_key_here"
```

**Response**

```json theme={null}
{
  "@context": "https://schema.org",
  "@type": "Dataset",
  "name": "axiom-locus-scores-sf",
  "description": "Location intelligence scores for San Francisco metro area",
  "license": "https://axiomlocus.io/terms",
  "distribution": [
    {
      "@type": "DataDownload",
      "encodingFormat": "application/jsonl",
      "contentUrl": "https://axiomlocus.io/api/exports/training-data?dataset=scores&metro=sf&format=jsonl"
    }
  ],
  "variableMeasured": [
    { "name": "composite", "description": "Overall score 0-100" },
    { "name": "businessVitality", "description": "Business vitality signal 0-100" }
  ]
}
```

| Field              | Type   | Description                              |
| ------------------ | ------ | ---------------------------------------- |
| `@type`            | string | Always 'Dataset' (schema.org).           |
| `distribution`     | array  | Available download formats and URLs.     |
| `variableMeasured` | array  | Feature descriptions for ML consumption. |

## `GET` `/api/exports/training-data`

<Note>Requires Bearer token.</Note>

Download training data in JSONL or CSV format for ML pipelines. Each row is one H3 cell with all features.

**Query parameters**

| Name      | Type   | Required | Default | Description                                               |
| --------- | ------ | -------- | ------- | --------------------------------------------------------- |
| `dataset` | string | ✓        |         | Dataset name: scores, permits, pois, crime, demographics. |
| `format`  | string |          | `jsonl` | Output format: jsonl or csv.                              |
| `metro`   | string |          |         | Metro slug filter.                                        |
| `limit`   | int    |          | `10000` | Max rows (50,000 max for Team plan).                      |
| `since`   | string |          |         | Only records updated since this ISO date.                 |

**Example**

```bash theme={null}
curl "https://axiomlocus.io/api/exports/training-data?dataset=scores&format=jsonl&metro=sf&limit=1000" \
  -H "Authorization: Bearer al_your_key_here" -o training.jsonl
```

**Response**

```json theme={null}
{"h3_index":"882a100d63fffff","metro":"sf","composite":76.2,"businessVitality":82,"populationMomentum":71,"demographics":80,"economicStrength":74,"developmentPipeline":78,"accessibility":69,"safety":65,"amenity":72}
{"h3_index":"882a100d65fffff","metro":"sf","composite":71.8,"businessVitality":75,"populationMomentum":68,"demographics":77,"economicStrength":70,"developmentPipeline":72,"accessibility":65,"safety":62,"amenity":69}
```

| Field            | Type   | Description                               |
| ---------------- | ------ | ----------------------------------------- |
| `h3_index`       | string | H3 cell identifier at resolution 8.       |
| `composite`      | float  | Overall composite score.                  |
| `[signal_group]` | float  | Individual signal group scores (8 total). |
