# Casa Sapo Agencies API

<p>List the real estate agencies of the Casa Sapo directory, one page at a time. Each agency has its id, slug, name, AMI licence, company, logo, website, address, listing count and profile url. Telephone numbers are never returned. Use the id with the agency and agency-listings endpoints. Casa Sapo publishes the content signal ai-train=no: do not use this data to train AI models.</p>

- **Documentation:** [https://scrappa.co/docs/casa-sapo-api/casa_sapo_agencies](https://scrappa.co/docs/casa-sapo-api/casa_sapo_agencies)
- **API group:** Casa Sapo API
- **Endpoint:** `GET https://scrappa.co/api/casa-sapo/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.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `page` | integer | No | Page number, 1-based. |

## Example response

```json
{
    "data": {
        "agencies": [
            {
                "id": "14457",
                "logo": "https://media.egorealestate.com/150x70/6e0b8eca-f48f-4d07-a6b0-e6ecc151e759.png",
                "name": "IMOJOY Real Estate",
                "slug": "imojoy-real-estate",
                "address": "Rua dos Sobreiros, 25 C, Costa da Guia, Cascais",
                "company": "Ag\u00eancia Imobili\u00e1ria",
                "license": "12689",
                "website": "http://imojoy.pt",
                "profile_url": "https://casa.sapo.pt/agencia/imojoy-real-estate/?cl=14457&sys=5"
            }
        ],
        "pagination": {
            "page": 1,
            "per_page": 20,
            "has_next_page": true
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "agencies"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | The listing, agency or location does not exist. This response is not billable. |  |
|  | A parameter or filter is missing or invalid. This response is not billable. |  |
|  | Casa Sapo answered a page that no longer matches the documented contract. This response is not billable. |  |
|  | Casa Sapo is temporarily unavailable. Retry the request. 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)