Idealista

Advaticer Listing API

GET https://api.dataextractorpro.com/advaticer_listing ⚡ 1 Credit

Retrieve property listings from specific advertisers, including agents, agencies, or private owners on Idealista.

Overview

This API endpoint allows programmatically extracting clean, structured data for Idealista.

Authentication

Include your API key in the request header:

                                x-api-key: YOUR_API_KEY
                            

Request Parameters

Parameter	Type	Required	Description & Allowed Values
url url	text	Required	Value for this parameter can be obtained from the agencyUrl field returned by the Search Listing and Rent Listing endpoints.
type type	select	Required	type Allowed Values: home newhome office commercialproperty garage land storagerooms buildings +1 more
page page	text	Optional	page
sort sort	select	Optional	sort Allowed Values: relevant lowestprice highestprice newest lowestfloor highestfloor smallestarea largestarea +3 more

Code Examples

Error Responses

400 Invalid Parameters

One or more required parameters are missing or invalid.

{
    "status": "error",
    "message": "Parameter 'q' is required"
}

401 Unauthorized

Invalid or missing API key in x-api-key header.

{
    "status": "error",
    "message": "Invalid API key"
}

429 Rate Limit / Quota Exceeded

API key usage quota has been exhausted.

{
    "status": "error",
    "message": "Usage limit reached"
}

500 Internal Server Error

An unexpected server error occurred during extraction.

{
    "status": "error",
    "message": "Internal extraction error"
}