Com APImercadolibre.com.ar ↗
Search and retrieve MercadoLibre Argentina listings for products, cars, and real estate. Access prices, seller profiles, reviews, and specs via 6 endpoints.
What is the Com API?
The MercadoLibre Argentina API covers 6 endpoints for querying and retrieving data across three listing verticals: general products, vehicles, and real estate. The search_listings endpoint returns paginated product results with price, shipping status, and promotion flags, while get_product_details exposes full item attributes, images, sold quantity, and a text description. Seller reputation and customer review data are also accessible per item ID.
curl -X GET 'https://api.parse.bot/scraper/bb9a5793-4c63-4939-bc43-a7d86594e527/search_listings?query=notebook&offset=0' \ -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 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 Argentina SDK — search products, cars, and real estate."""
from parse_apis.mercadolibre_argentina_api import (
MercadoLibre, Operation, PropertyType, ItemNotFound
)
client = MercadoLibre()
# Search for product listings — limit= caps total items fetched.
for listing in client.listings.search(query="notebook", limit=3):
print(listing.title, listing.price, listing.currency)
# Drill down: take one listing and get full product details.
listing = client.listings.search(query="celular samsung", limit=1).first()
if listing:
detail = listing.details()
print(detail.title, detail.price, detail.seller)
# Walk sub-resource: reviews for this listing.
for review in listing.reviews.list(limit=3):
print(review.rating, review.text)
# Search cars by brand.
for car in client.carlistings.search(brand="Toyota", limit=3):
print(car.title, car.year, car.kilometers, car.location)
# Search real estate with enum filters.
for prop in client.propertylistings.search(
operation=Operation.VENTA,
property_type=PropertyType.DEPARTAMENTOS,
limit=3
):
print(prop.title, prop.price, prop.currency, prop.location)
# Get seller profile using an item ID — typed error handling.
try:
seller = client.sellerprofiles.get_by_item(item_id="MLA1424712885")
print(seller.name, seller.reputation)
except ItemNotFound as exc:
print(f"Item not found: {exc.item_id}")
print("exercised: listings.search / details / reviews.list / carlistings.search / propertylistings.search / sellerprofiles.get_by_item")
Search for product listings on MercadoLibre Argentina. Returns paginated results with items including price, title, and shipping info. Each page yields approximately 48 results. Pagination is offset-based with increments visible in the returned pagination_nodes_url.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keywords (e.g. 'notebook', 'celular', 'zapatillas') |
| offset | integer | Results offset for pagination. Each page contains approximately 48 results. |
| category | string | Category slug to narrow search results (e.g. 'computacion') |
{
"type": "object",
"fields": {
"items": "array of product listings, each with id, title, price, currency, permalink, shipping, and is_promoted",
"pagination": "object with page_count, selected_page, next_page, and pagination_nodes_url",
"total_results": "total number of results or null if unavailable"
},
"sample": {
"data": {
"items": [
{
"id": "MLA1424712885",
"price": 318449,
"title": "Notebook Exo Smart T38 Intel N4020 4gb Ssd128gb Windows 11 Color Gris",
"currency": "ARS",
"shipping": "Llega gratis hoy",
"permalink": "https://www.mercadolibre.com.ar/notebook-exo-smart-t38/p/MLA22826188",
"is_promoted": false
}
],
"pagination": {
"page_count": 42,
"selected_page": 1
},
"total_results": null
},
"status": "success"
}
}About the Com API
Search Endpoints
Three search endpoints map to MercadoLibre Argentina's main verticals. search_listings accepts a query string, an optional category slug (e.g. computacion), and an offset integer for pagination — each page holds approximately 48 results. The response includes an items array with id, title, price, currency, permalink, shipping, and is_promoted per listing, plus a pagination object with page_count, selected_page, and next_page. search_cars accepts brand, model, and a free-text query, returning items with year, kilometers, and location fields. search_real_estate filters by location, operation (venta or alquiler), and property_type (casas, departamentos, terrenos), returning items with surface and location.
Product Detail and Reviews
get_product_details takes a single item_id (e.g. MLA2842881704) and returns a richer record: an images array of URLs, an attributes array of product specifications, a full description string, condition, sold_quantity, and seller name. get_product_reviews accepts the same item_id and returns a reviews array with id, rating, text, and date per review, plus aggregate fields: rating_average, total_reviews, and a rating_levels breakdown by star count.
Seller Profiles
get_seller_profile resolves seller data from any item ID belonging to that seller. The response includes a numeric id, name, a reputation string (e.g. 5_green), and a status object with title, sales count, and level detail. This allows cross-referencing seller quality without needing a separate seller ID lookup.
Coverage Notes
All data is scoped to MercadoLibre Argentina (MLA item prefix). Prices are returned in the currency the seller lists in — typically ARS but sometimes USD for real estate and vehicles. Fields like sold_quantity, total_results, rating_levels, and condition may return null when the source does not expose them for a given listing.
The Com API is a managed, monitored endpoint for mercadolibre.com.ar — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when 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 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?+
- Monitor price changes for specific product categories by polling
search_listingswith acategoryslug over time - Build a used car valuation dataset using
search_carsfiltered bybrandandmodelwithyearandkilometersfields - Aggregate Buenos Aires rental and sale prices by neighborhood using
search_real_estatewithoperationandlocationfilters - Evaluate seller trustworthiness before purchase by fetching
get_seller_profilereputation and sales count from any item ID - Extract product specification tables from
get_product_detailsattributesarrays for comparison engines or catalogues - Analyze review sentiment and rating distribution using
get_product_reviewstextandrating_levelsfields - Detect promoted vs organic listings in search results using the
is_promotedflag fromsearch_listings
| 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 have an official developer API?+
How does pagination work in search_listings?+
offset parameter shifts the result window. Each page holds approximately 48 items. The response pagination object includes page_count, selected_page, next_page, and pagination_nodes_url so you can walk through result pages sequentially. total_results reflects the full match count but may be null for some queries.Does the API return seller contact details such as phone numbers or email addresses?+
get_seller_profile returns id, name, reputation, and a status object with sales-level information. Direct contact details are not exposed. You can fork this API on Parse and revise it to add an endpoint targeting seller contact data if that field becomes accessible.Does the real estate endpoint return property images or floor plan URLs?+
search_real_estate response includes id, title, price, currency, location, surface, and permalink per listing. Image data is not currently returned by that endpoint. get_product_details does return an images array for general MLA items, but there is no equivalent detail endpoint for real estate or vehicles. You can fork the API on Parse and revise it to add a real-estate detail endpoint that exposes images.