inmuebles.mercadolibre.com.ar APIinmuebles.mercadolibre.com.ar ↗
Search and retrieve apartment listings from MercadoLibre Argentina. Get prices, addresses, descriptions, and structured attributes via 2 endpoints.
curl -X GET 'https://api.parse.bot/scraper/3f5a7b6f-07e9-4b94-bf35-1aeffe75d7f1/search_apartments?limit=5&pages=1&location=capital-federal' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for apartment listings in a specified location on MercadoLibre Argentina. Returns paginated results with basic listing info including title, price, address, and property attributes. Each page contains up to 48 listings.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of listings to return. Omitting returns all listings found across the requested pages. |
| pages | integer | Number of pages to scrape (48 listings per page). |
| location | string | URL-friendly location slug for filtering results (e.g. 'capital-federal', 'cordoba', 'palermo'). |
| include_details | boolean | Whether to fetch full details (description, extended attributes) for each listing. Significantly slower when true. |
{
"type": "object",
"fields": {
"listings": "array of listing objects each containing item_id, title, url, price, address, and attributes",
"total_found": "integer count of listings returned"
},
"sample": {
"data": {
"listings": [
{
"url": "https://departamento.mercadolibre.com.ar/MLA-3167841492-alquiler-departamento-2-amb-en-recoleta-_JM",
"price": "$850.000",
"title": "Alquiler Departamento 2 Amb En Recoleta",
"address": "Anchorena Al 1600, Palermo, Capital Federal",
"item_id": "MLA-3167841492",
"attributes": "2 ambs. | 1 baño | 42 m² cubiertos"
}
],
"total_found": 5
},
"status": "success"
}
}About the inmuebles.mercadolibre.com.ar API
This API exposes 2 endpoints for accessing apartment listings on MercadoLibre Argentina's real estate section (inmuebles.mercadolibre.com.ar). The search_apartments endpoint returns paginated results — up to 48 listings per page — with fields including item ID, title, URL, price, address, and property attributes. The get_listing_detail endpoint retrieves full details for a single listing, including the description text and structured attribute map.
Searching Listings
The search_apartments endpoint accepts a location parameter as a URL-friendly slug (e.g. capital-federal, palermo, cordoba) to filter results by area. You control how many pages to retrieve via the pages parameter, with each page containing up to 48 listings. The response includes a listings array — each object carrying item_id, title, url, price, address, and an attributes array — plus a total_found count. Setting include_details to true fetches full listing data for every result in the search, at the cost of significantly longer response time.
Retrieving Listing Details
The get_listing_detail endpoint takes the full listing url (typically sourced from search_apartments results) and returns the complete record: formatted price with currency symbol, address, description text, and an attributes object mapping feature names to values (covering amenities, property features, and similar structured data). This endpoint is suited for building detailed property records when the search summary fields are insufficient.
Pagination and Coverage
Results are scoped to apartments listed on the Argentine MercadoLibre real estate vertical. Pagination is controlled by the pages input — omitting limit returns all listings found across requested pages. Location slugs must match MercadoLibre Argentina's URL conventions; the API does not validate or resolve free-text city names. Data freshness reflects the current state of the live listing index.
- Aggregate Buenos Aires apartment prices by neighborhood using the
locationslug parameter - Build a rental market dashboard comparing
priceandattributesacross multiplelocationslugs - Monitor new listings in a specific area by polling
search_apartmentsand trackingitem_idchanges - Extract full
descriptionandattributesdata from individual listings viaget_listing_detailfor property comparison tools - Compile a dataset of property features (amenities, surface area, rooms) from the
attributesobject across many listings - Feed structured listing data into a CRM or lead-generation system using
url,address, andpricefields - Research asking-price distributions across Argentine provinces by varying the
locationparameter
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does MercadoLibre Argentina have an official developer API?+
What does `search_apartments` return when `include_details` is set to true?+
include_details is true, each listing object in the listings array is augmented with the full fields from get_listing_detail — including description and the complete attributes map — rather than just the summary fields from the search results page. Response time increases substantially because a detail fetch is performed for every listing in the result set.Does the API cover property types other than apartments — houses, commercial spaces, or land?+
Is there a known limitation with the `location` parameter?+
location value must be a valid URL-friendly slug matching MercadoLibre Argentina's own location identifiers (e.g. capital-federal, palermo). Passing free-text city names or arbitrary strings will not resolve correctly. You need to match the slug format used in MercadoLibre Argentina's real estate URL paths.Does the API return contact details or agent information for listings?+
price, address, description, and attributes — seller contact details or agent profiles are not exposed. You can fork this API on Parse and revise it to extract that information if it is available on the listing page.