Access agency property listings directly.
Submit an agency identifier and location to receive a structured list of their current inventory. No browser automation or manual searching required.
How it works
One request, one response.
- 1
Submit Agency Identifier
Provide the micrositeShortName, location, and desired operation in a single POST request.
- 2
Retrieve Listing Data
The API queries the specific agency profile and extracts all active property details from their portfolio.
- 3
Process Structured JSON
Receive a standardized list of properties including prices, locations, and key specifications ready for integration.
Capabilities
What you get.
Everything this endpoint does, without running the infrastructure yourself.
Multi-region support
Query agencies operating in Spain, Italy, or Portugal using the location parameter.
Operation filtering
Filter results to show only active sales or rental listings via the operation parameter.
Localized responses
Retrieve property descriptions and details in nine different languages by setting the locale flag.
Standardized output
Returns consistent property objects containing price, dimensions, and location data regardless of the agency's custom site layout.
Cost of ownership
Build it yourself, or call this.
Both are real options. Here is what each one actually costs you.
Run it yourself
- Build custom scrapers for various microsite layouts
- Manage complex proxy rotation and CAPTCHA bypasses
- Handle frequent UI changes across three countries
- Maintain data parsing logic for multiple languages
Call the API
- Single unified POST request for all agencies
- Automatic handling of regional platform variations
- Clean JSON output optimized for CRM ingestion
- Pay only for successful listing retrievals
Integrate
Built for the language you use.
One HTTP endpoint. Copy the call in your language and go.
curl -X POST https://automatio.ai/api/v1/query \
-H "Authorization: Bearer $AUTOMATIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "tool": "idealista_agency_locations", "params": { "micrositeShortName": "example", "location": "example", "locationId": "example", "operation": "example" } }'In production
What people build with it.
Competitor Inventory Monitoring
Track the stock levels and pricing strategies of specific real estate agencies over time by fetching their public listings. This allows for market share analysis and competitive benchmarking.
CRM Data Synchronization
Keep internal real estate databases updated by automatically pulling the latest public listings from a partner agency's portfolio. The structured JSON maps directly to common property management schemas.
Local Market Saturation Analysis
Determine how many properties a specific agency controls in a given locationId. This data helps assess which agencies dominate specific neighborhoods or municipalities.
Choosing parameters
Which options matter.
The table below lists what exists. These are the calls worth making deliberately.
- micrositeShortName
- location
- operation
Alternatives
When to use something else.
A page that pretends it has no alternatives reads as an advert. These are the other real options.
Official Platform API
Offers the highest reliability but typically requires enterprise-level commercial agreements and strict vetting of use cases.
Manual Browser Scraping
Provides full control over data extraction but is fragile and expensive to maintain due to aggressive anti-bot measures.
Before you integrate
What it does not do.
The boundaries are as useful as the features. These are the ones worth knowing up front.
Active listings only
This endpoint does not provide historical data or details for sold, expired, or archived properties that are no longer public.
Microsite dependency
The agent must have an active, public microsite profile on the origin platform for this endpoint to locate their property inventory.
Portfolio pagination
Agencies with very large inventories may have their listings split across pages; you may need to handle pagination to retrieve a complete portfolio.
Reference
135 credits per call- Endpoint
- POST https://automatio.ai/api/v1/query
- Tool ID
- idealista_agency_locations
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| micrositeShortName | string | Agency slug from idealista.com/pro/{slug}/ | |
| location | "es" | "pt" | "it" | Country code: Spain (es), Portugal (pt), Italy (it) | |
| locationId | string | Root locationId to scope the search (use a broad location like a province) | |
| operation | "sale" | "rent" | Property operation type | |
| locale | "es" | "it" | "pt" | "en" | "ca" | "de" | "fr" | "nl" | "nb" | — | Response language (default: en) |
The same endpoints are available over MCP, and the full machine-readable catalogue lives in the API documentation.
Frequently Asked Questions
Find answers to common questions about Agency Listings API
Same data source
Every Real estate endpoint.
One key, one endpoint shape. These all bill per successful call the same way.
Property Locations API
Retrieve structured geographic metadata for Idealista location IDs across Spain, Italy, and Portugal. Get accurate regional data for real estate integrations.
135 creditsReal Estate Agency API
Extract structured real estate agency data from Idealista using the microsite ID. Access contact details, portfolio size, and metadata for Spain, Italy, and...
135 creditsIdealista Property Search API
Search real estate listings across Spain, Italy, and Portugal. Filter by location, price, and features like pools or terraces to get structured property data.
135 creditsProperty Details API
Get structured Idealista property data for Spain, Italy, and Portugal. Access prices, features, and localized descriptions via a single POST request.
135 creditsLocation Autocomplete API
Access real-time location suggestions from Idealista for Spain, Italy, and Portugal. Convert partial text strings into valid geographic identifiers for search.
135 creditsOther endpoints
Browse all APIs →Supercharge your workflow with AI Automation
Automatio combines the power of AI agents, web automation, and smart integrations to help you accomplish more in less time.