# Supercasa Agency Profile

Fetch one Supercasa agency profile: name, logo, published licence, locality and the listings it currently publishes. Use the slug_id, business and locality values returned by the agencies endpoint. 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_agency](https://scrappa.co/docs/supercasa-api/supercasa_agency)
- **API group:** Supercasa API
- **Endpoint:** `GET https://scrappa.co/api/supercasa/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 |
| --- | --- | --- | --- |
| `agency` | string | Yes | Agency handle as returned by the agencies endpoint, e.g. blyss-real-estate-6957. |
| `business` | string | Yes | comprar or arrendar — the tail every Supercasa profile URL carries. |
| `location` | string | Yes | Locality slug, e.g. lisboa. |

## Example request

```bash
#!/bin/bash

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

## Example response

```json
{
    "success": true,
    "slug_id": "blyss-real-estate-6957",
    "name": "Blyss Real Estate",
    "business": "comprar",
    "location": "lisboa",
    "ami_licence": "19794",
    "listings_count": 15,
    "listings": [
        {
            "listing_id": 2165197,
            "url": "https://supercasa.pt/venda-apartamento-t2-lisboa/i2165197"
        }
    ]
}
```

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