Extract real estate agency profiles instantly.
Pass a microsite ID and region to get structured contact details, descriptions, and portfolio metrics. No proxy management or DOM parsing required.
How it works
One request, one response.
- 1
Submit identifier
Send the micrositeShortName and the specific country location code in a JSON request.
- 2
Scrape profile
The API navigates to the public agency microsite and extracts relevant metadata fields.
- 3
Receive data
Get a structured JSON response containing the agency's contact info, description, and listing counts.
Capabilities
What you get.
Everything this endpoint does, without running the infrastructure yourself.
Multi-region support
Retrieve data for agencies across Spain, Italy, and Portugal using standardized location codes.
Contact extraction
Automatically identify and structure phone numbers, physical office addresses, and website links.
Portfolio metrics
Access the total count of active listings to gauge an agency's size and market influence.
Branding assets
Extract URLs for agency logos and banners to keep external directories visually synchronized.
Cost of ownership
Build it yourself, or call this.
Both are real options. Here is what each one actually costs you.
Run it yourself
- Manage residential proxy pools to avoid blocks
- Build and maintain parsers for three different DOM structures
- Solve localized CAPTCHAs and session challenges
Call the API
- Standardized JSON output across all supported regions
- Zero infrastructure maintenance or browser scaling
- Unified endpoint with managed proxy rotation
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_profile", "params": { "micrositeShortName": "example", "location": "example" } }'In production
What people build with it.
CRM Lead Enrichment
Supply a micrositeShortName to fetch office addresses and phone numbers. This data is formatted for direct ingestion into sales pipelines to ensure broker contact information is always current.
Market Saturation Analysis
Input the identifier to retrieve the total number of active listings for a specific firm. Use this to monitor agency growth or market share shifts within specific Mediterranean urban centers.
Agency Directory Aggregation
Fetch agency descriptions and logo URLs to populate localized real estate portals. The API handles the extraction of branding assets so third-party sites stay consistent with the origin platform.
Choosing parameters
Which options matter.
The table below lists what exists. These are the calls worth making deliberately.
- micrositeShortName
- location
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 API Access
Provides higher rate limits but requires a lengthy commercial approval process and significantly higher monthly minimums.
Manual Web Scraping
Avoids per-call costs but requires significant engineering time to manage rotating proxies and frequent UI changes.
Before you integrate
What it does not do.
The boundaries are as useful as the features. These are the ones worth knowing up front.
Public profiles only
This endpoint cannot access private broker accounts or agent-only dashboards. Only data visible on a publicly accessible agency microsite is returned.
Regional scope
Data retrieval is restricted to the specific country codes supported by the origin platform. Profiles from other countries cannot be processed by this tool.
Current state only
The API provides a snapshot of the profile as it exists now. It does not include historical listing data or a timeline of agency changes.
Reference
135 credits per call- Endpoint
- POST https://automatio.ai/api/v1/query
- Tool ID
- idealista_agency_profile
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) |
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 Real Estate Agency 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 creditsAgency Listings API
Extract property listings for real estate agencies on Idealista. Get structured data for sales or rentals in Spain, Italy, and Portugal via JSON.
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.