Skip to content
Scrappa Get API key
Casa Sapo API 1 credit/request

Casa Sapo Agencies API

GET https://scrappa.co/api/casa-sapo/agencies

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.

Casa Sapo Agencies API 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/casa-sapo/agencies
Auth header
x-api-key
Cost
1 credit/request
Response preview
200 OK
{
    "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"
            }
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

This endpoint has no required query parameters.

1 optional filter available.

page integer Optional

Page number, 1-based.

Example value 1

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "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

Handle these documented responses before retrying or showing customer-facing failures.

404

HTTP 404

The listing, agency or location does not exist. This response is not billable.

422

HTTP 422

A parameter or filter is missing or invalid. This response is not billable.

502

HTTP 502

Casa Sapo answered a page that no longer matches the documented contract. This response is not billable.

503

HTTP 503

Casa Sapo is temporarily unavailable. Retry the request. This response is not billable.

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.