Com APIinmuebles.mercadolibre.com.ar ↗
Search and retrieve apartment listings from MercadoLibre Argentina. Get prices, addresses, descriptions, and structured attributes via 2 endpoints.
What is the Com 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.
curl -X GET 'https://api.parse.bot/scraper/3f5a7b6f-07e9-4b94-bf35-1aeffe75d7f1/search_apartments?limit=3&pages=1&location=cordoba&include_details=false' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace inmuebles-mercadolibre-com-ar-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: MercadoLibre Inmuebles Argentina — search apartments and view details."""
from parse_apis.mercadolibre_inmuebles_argentina_api import (
MercadoLibreInmuebles,
ListingSummary,
Listing,
ListingNotFound,
)
client = MercadoLibreInmuebles()
# Search apartments in Capital Federal — limit caps total items fetched.
for apt in client.listingsummaries.search(location="capital-federal", pages=1, limit=5):
print(apt.title, apt.price, apt.address)
# Drill into the first result's full details via .details() navigation.
first = client.listingsummaries.search(location="capital-federal", pages=1, limit=1).first()
if first:
detail = first.details()
print(detail.price, detail.address)
print(detail.description[:120] if detail.description else "No description")
for attr_name, attr_value in detail.attributes.items():
print(attr_name, attr_value)
# Direct lookup by URL when you already have one.
try:
listing = client.listings.get(url=first.url)
print(listing.price, listing.address)
except ListingNotFound as exc:
print(f"Listing removed: {exc.url}")
print("exercised: listingsummaries.search / ListingSummary.details / listings.get")
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. The PoW challenge is solved automatically on first request.
| 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. Known working values include 'capital-federal', 'cordoba', 'palermo', 'rosario'. The site accepts many more location slugs. |
| 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-2747611218-edificio-en-las-canitas-_JM",
"price": "US$100.016",
"title": "Edificio En Las Cañitas",
"address": "Arce 523 - Lifestyle Arce, Las Cañitas, Capital Federal",
"item_id": "MLA-2747611218",
"attributes": "1 a 3 ambs. | 1 a 2 baños | 28 - 144 m² cubiertos"
}
],
"total_found": 3
},
"status": "success"
}
}About the Com API
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.
The Com API is a managed, monitored endpoint for inmuebles.mercadolibre.com.ar — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when inmuebles.mercadolibre.com.ar changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official inmuebles.mercadolibre.com.ar API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.