# Casa Sapo Agency API

<p>Retrieve one agency profile: name, AMI licence, company, logo, address, opening schedule, website, the number of listings and the profile url. Telephone numbers are never returned. Unknown agency ids answer 404 and are not billed. 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_agency](https://scrappa.co/docs/casa-sapo-api/casa_sapo_agency)
- **API group:** Casa Sapo API
- **Endpoint:** `GET https://scrappa.co/api/casa-sapo/agency`

## 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 |
| --- | --- | --- | --- |
| `id` | integer | Yes | Numeric Casa Sapo agency id, e.g. 14457, from the agencies endpoint or the advertiser.id field of a listing. |

## Example response

```json
{
    "data": {
        "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": "Ant\u00f3nio Silvestre, Media\u00e7\u00e3o Imobili\u00e1ria Lda",
        "license": "12689",
        "website": "http://imojoy.pt",
        "schedule": "2\u00aa feira a S\u00e1bado das 10h00 \u00e0s 19h00",
        "profile_url": "https://casa.sapo.pt/agencia/imojoy-real-estate/?cl=14457&sys=5",
        "listing_count": 1385
    },
    "meta": {
        "billable": true,
        "endpoint_family": "agency"
    },
    "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)