# Fincaraiz Taxonomy API Documentation

Scrappa's `GET /api/fincaraiz/taxonomy` returns the platform's own vocabularies: property types, transaction types, and countries.

Use `property_types` and `operation_types` to drive a filter UI. Note that `operation_type_id` 1 is sale and 2 is rent — the same values the search endpoint takes.

The `countries` list mixes genuine countries with regional brands, so treat it as the platform publishes it and select Colombia (`id` 3) for the Colombian market. For the full filter catalogue including options, use available-filters.

- **Documentation:** [https://scrappa.co/docs/fincaraiz-api/fincaraiz_taxonomy](https://scrappa.co/docs/fincaraiz-api/fincaraiz_taxonomy)
- **API group:** Fincaraiz API
- **Endpoint:** `GET https://scrappa.co/api/fincaraiz/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.

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/fincaraiz/taxonomy"
```

## Example response

```json
{
    "success": true,
    "property_types": [
        {
            "id": 1,
            "name": "Casa"
        },
        {
            "id": 2,
            "name": "Apartamento"
        }
    ],
    "operation_types": [
        {
            "id": 1,
            "name": "Venta"
        },
        {
            "id": 2,
            "name": "Arriendo"
        }
    ],
    "countries": [
        {
            "id": 3,
            "name": "Colombia"
        }
    ],
    "meta": {
        "billable": true,
        "endpoint_family": "taxonomy",
        "attempts": 1
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 503 | Unreadable Response | The platform answered successfully with a body this endpoint cannot read, so nothing is published and nothing is charged (`parser_drift`). Retryable. |
| 503 | Upstream Unavailable | The upstream request failed after retries. Retryable and never billed. |

## Frequently asked questions

### Which operation_type_id is a sale?

1 is venta (sale) and 2 is arriendo (rent). Both are the default and explicit values for the search operation_type_id filter.

## Related endpoints

- [Available Filters](https://scrappa.co/docs/fincaraiz-api/fincaraiz_available_filters)
- [Search](https://scrappa.co/docs/fincaraiz-api/fincaraiz_search)

## 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)