# Kavak Taxonomy

List the makes of a market with their model counts, the locations with their hubs, the filter values (body type, year, transmission, colour, seats, fuel, availability, drivetrain), the price and km ranges and the sort options. Pass make to list the models of one make. The values are the exact values the search endpoint accepts. Values are published per market and in the language of the market. Turkey publishes no taxonomy and is rejected with a 422.

- **Documentation:** [https://scrappa.co/docs/kavak-api/kavak_taxonomy](https://scrappa.co/docs/kavak-api/kavak_taxonomy)
- **API group:** Kavak API
- **Endpoint:** `GET https://scrappa.co/api/kavak/v1/taxonomy`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `market` | string | Yes | Market code: mx, br, ar, cl or ae. |
| `make` | string | No | Make value, returns the models of that make. |

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | A parameter is invalid, the market is not served, or a make, model or location value is unknown. This response is not billable. |  |
|  | The upstream answer changed shape or answered for another market and could not be used. This response is not billable. |  |
|  | The upstream refused the request or is unavailable. This response is not billable. |  |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)