# Fincaraiz Agency API Documentation

Scrappa's `GET /api/fincaraiz/agencies` returns the full directory of Colombian real-estate agencies in a single call, and `/api/fincaraiz/agency` returns one agency profile.

The directory arrives complete — more than two thousand agencies — with no cursor and no pagination. Premium agencies are returned separately under `premium`; the rest are under `agencies`.

To list one agency's listings, use `/api/fincaraiz/agency-properties?owner_id=...` with the agency id. That is the same search endpoint narrowed by owner, so it carries the same filters and the same reliable total.

Contact details are returned masked. Agency email addresses and unmasked phone numbers are never selected.

- **Documentation:** [https://scrappa.co/docs/fincaraiz-api/fincaraiz_agencies](https://scrappa.co/docs/fincaraiz-api/fincaraiz_agencies)
- **API group:** Fincaraiz API
- **Endpoint:** `GET https://scrappa.co/api/fincaraiz/agencies`

## 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/agencies"
```

## Example response

```json
{
    "success": true,
    "returned": 2273,
    "premium_count": 32,
    "standard_count": 2241,
    "premium": [
        {
            "id": "176827195",
            "name": "Karpador inmobiliaria",
            "profile_url": "/inmobiliarias/perfil/176827195-karpador-inmobiliaria",
            "property_count": 6
        }
    ],
    "agencies": [],
    "meta": {
        "billable": true,
        "endpoint_family": "agencies",
        "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

### How many agencies are listed?

Around 2,270 — roughly 32 premium and 2,240 standard — and the whole directory arrives in one request with no pagination.

### Do you return agency contact details?

Phone numbers come back already masked by the platform. Email addresses are never selected.

## Related endpoints

- [Agency Inventory](https://scrappa.co/docs/fincaraiz-api/fincaraiz_agency_properties)
- [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)