# Supercasa Agencies

List the real estate agencies operating in a Portuguese locality, with each agency's handle, logo, listing counts and published licence identifier. Every entry carries the profile path needed to look the agency up individually. While this family is withdrawn the endpoint answers 410 Gone with no upstream request and no charge; search, property, filters and autocomplete keep serving.

- **Documentation:** [https://scrappa.co/docs/supercasa-api/supercasa_agencies](https://scrappa.co/docs/supercasa-api/supercasa_agencies)
- **API group:** Supercasa API
- **Endpoint:** `GET https://scrappa.co/api/supercasa/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 |
| --- | --- | --- | --- |
| `location` | string | Yes | Locality slug, e.g. lisboa or porto. |
| `business` | string | No | comprar (default) or arrendar. |
| `page` | integer | No | Directory page number. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/supercasa/agencies?location=lisboa&business=comprar"
```

## Example response

```json
{
    "success": true,
    "location": "lisboa",
    "page": 1,
    "results_count": 25,
    "agencies": [
        {
            "name": "Blyss Real Estate",
            "slug_id": "blyss-real-estate-6957",
            "profile_path": "/pro/blyss-real-estate-6957/comprar/lisboa",
            "url": "https://supercasa.pt/pro/blyss-real-estate-6957/comprar/lisboa",
            "logo": "https://media.egorealestate.com/150x70/c7aa0314.jpg",
            "listings_in_location": 19,
            "listings_total": 32,
            "ami_licence": "21594"
        }
    ]
}
```

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