Skip to content
Scrappa Get API key
Tecnocasa API 1 credit/request

Tecnocasa Agency Listings API Documentation

GET https://scrappa.co/api/tecnocasa/v1/agency/listings
Get API key Open Playground

Tecnocasa Agency Listings API lists the ads of one agency with the same cards, filters, sort and paging as the search route.

Notes: Take agency_id, city_id and province from agency.id and agency.search of the agency route. Prices, areas and counts are numbers and the original text is kept in raw or label fields. A hidden price (for example Informazioni in agenzia) is null, never 0. A valid empty result is a successful, billable response; failed requests are never billed.

Tecnocasa Agency Listings API Documentation 1 credit/request
Get API key Open Playground

Endpoint

Request preview
GET
https://scrappa.co/api/tecnocasa/v1/agency/listings
Auth header
x-api-key
Cost
1 credit/request
agency_id = 1234567890 city_id = 1234567890 province = example
Response preview
200 OK 
{
    "data": {
        "listings": [
            {
                "id": 61290658,
                "top": true,
                "price": {
                    "raw": "\u20ac 730.000",
                    "amount": 730000,
                    "period": null,
                    "currency": "EUR"
                },
                "rooms": 4,
                "title": "Quadrilocale in vendita",
...

Parameters

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

Runnable path

3 required parameters needed before sending a request.

15 optional filters available.

agency_id city_id province
agency_id string Required

Agency id, for example mice0.

Example value 1234567890
city_id integer Required

City id from the locations route (cities[].city_id). Example: 13800324507779.

Example value 1234567890
province string Required

Province code from the locations route (cities[].province). Example: MI.

Example value example
country string Optional

it (default) for Tecnocasa Italy or es for Tecnocasa Spain. Example: es.

Example value US
listing_type string Optional

sale (default) or rent. Example: rent.

Example value example
region string Optional

Optional region code. The province decides it when omitted. Example: lom.

Example value US
min_price integer Optional

Minimum price in EUR. For rent this is the monthly rent. Example: 200000.

Example value 10
max_price integer Optional

Maximum price in EUR. Example: 300000.

Example value 10
min_surface integer Optional

Minimum area in m2. Example: 80.

Example value 10
max_surface integer Optional

Maximum area in m2. Example: 120.

Example value 10
min_rooms integer Optional

Minimum number of rooms (Spain: bedrooms). Example: 3.

Example value 10
max_rooms integer Optional

Maximum number of rooms. Example: 4.

Example value 10
bathrooms integer Optional

Exact number of bathrooms. There is no minimum filter because the source ignores it. Example: 2.

Example value 10
property_type string Optional

app (apartment), vil (villa), cas (house), box (garage or parking space) or ter (land). Example: app.

Example value example
district_ids string Optional

One or more district ids from the locations route or the geo route. Repeat district_ids[] or comma-separate. Example: 10068,10072.

Example value example
sort string Optional

price_asc, price_desc, area_asc, area_desc, rooms_asc or rooms_desc. Default: promoted ads first, then source order. Example: price_asc.

Example value relevance
page integer Optional

One-based page number (default 1). A page past the last page returns an empty list with the real totals. Example: 2.

Example value 1
limit integer Optional

Results per page, 1 to 50 (default 15). Example: 15.

Example value 10

Response Schema

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

Open in Playground

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK 
{
    "data": {
        "listings": [
            {
                "id": 61290658,
                "top": true,
                "price": {
                    "raw": "\u20ac 730.000",
                    "amount": 730000,
                    "period": null,
                    "currency": "EUR"
                },
                "rooms": 4,
                "title": "Quadrilocale in vendita",
                "images": [
                    {
                        "id": 66921819,
                        "large": "https://cdn-media.medialabtc.it/it/agencies/mice0/estates/61290658/images/66921819/gallery.jpeg",
                        "order": 1,
                        "medium": "https://cdn-media.medialabtc.it/it/agencies/mice0/estates/61290658/images/66921819/detail.jpeg",
                        "thumbnail": "https://cdn-media.medialabtc.it/it/agencies/mice0/estates/61290658/images/66921819/card.jpeg"
                    }
                ],
                "surface": {
                    "m2": 141,
                    "raw": "141 Mq"
                },
                "discount": null,
                "subtitle": "Milano, Via Giovanni Battista Boeri - Meda Tibaldi",
                "agency_id": "mice0",
                "bathrooms": 2,
                "exclusive": false,
                "detail_url": "https://www.tecnocasa.it/vendita/appartamenti/milano/milano/61290658.html",
                "rooms_label": "4 locali",
                "virtual_tour": "https://www.smartvt360.it/pss/0af4aaed-e58e-455f-85a4-45db0406fbda",
                "previous_price": null,
                "bathrooms_label": "2 bagni"
            },
            {
                "id": 61219041,
                "top": true,
                "price": {
                    "raw": "\u20ac 450.000",
                    "amount": 450000,
                    "period": null,
                    "currency": "EUR"
                },
                "rooms": 3,
                "title": "Trilocale in vendita",
                "images": [
                    {
                        "id": 66851144,
                        "large": "https://cdn-media.medialabtc.it/it/agencies/mick0/estates/61219041/images/66851144/gallery.jpeg",
                        "order": 1,
                        "medium": "https://cdn-media.medialabtc.it/it/agencies/mick0/estates/61219041/images/66851144/detail.jpeg",
                        "thumbnail": "https://cdn-media.medialabtc.it/it/agencies/mick0/estates/61219041/images/66851144/card.jpeg"
                    }
                ],
                "surface": {
                    "m2": 80,
                    "raw": "80 Mq"
                },
                "discount": "\u20ac 20.000",
                "subtitle": "Milano, Via Casoretto - Casoretto",
                "agency_id": "mick0",
                "bathrooms": 1,
                "exclusive": false,
                "detail_url": "https://www.tecnocasa.it/vendita/appartamenti/milano/milano/61219041.html",
                "rooms_label": "3 locali",
                "virtual_tour": "https://www.smartvt360.it/pss/51e59c1e-a06a-4e88-844f-c33199a0a3a7",
                "previous_price": {
                    "raw": "\u20ac 470.000",
                    "amount": 470000,
                    "period": null,
                    "currency": "EUR"
                },
                "bathrooms_label": "1 bagno"
            }
        ],
        "search_metadata": {
            "page": 1,
            "limit": 15,
            "country": "it",
            "total_pages": 71,
            "filtered_out": 1,
            "listing_type": "sale",
            "has_next_page": true,
            "total_results": 1064,
            "page_out_of_range": false
        },
        "search_parameters": {
            "page": 1,
            "limit": 15,
            "region": "lom",
            "city_id": 13800324507779,
            "country": "it",
            "province": "MI",
            "agency_id": "mice0",
            "max_price": 800000,
            "min_price": 200000,
            "listing_type": "sale"
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "agency_listings"
    },
    "success": true
}

Errors

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

422

Validation Error

A required parameter or a value is invalid. This response is not billable.

{
    "errors": {
        "field": [
            "The field is invalid."
        ]
    },
    "message": "The request validation failed"
}
404

Not Found

The requested page does not exist. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": false,
        "endpoint_family": "agency_listings"
    },
    "error": {
        "code": "NOT_FOUND",
        "message": "The requested resource was not found."
    },
    "success": false
}
503

Upstream Unavailable

Tecnocasa could not be reached. This response is not billable and is retryable.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "agency_listings"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "Tecnocasa could not be reached. Please retry shortly."
    },
    "success": false
}
503

Unexpected Upstream Data

Tecnocasa returned data in an unexpected shape. This response is not billable and is retryable.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "agency_listings"
    },
    "error": {
        "code": "INVALID_UPSTREAM_SHAPE",
        "message": "Tecnocasa returned data in an unexpected shape. Please retry shortly."
    },
    "success": false
}

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.

Get API key Open Playground
Back to Home Full API reference