mercadolibre.com.ar 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.
curl -X GET 'https://api.parse.bot/scraper/bb9a5793-4c63-4939-bc43-a7d86594e527/search_listings?query=notebook' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for product listings on MercadoLibre Argentina. Returns paginated results with items including price, title, and shipping info.
| 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": "MLA2842881704",
"price": 747538,
"title": "Notebook Acer Gadget E10 Etbook Intel I5-12450h 16gb 512gb",
"currency": "ARS",
"shipping": null,
"permalink": "https://click1.mercadolibre.com.ar/mclics/clicks/external/MLA/count",
"is_promoted": true
}
],
"pagination": {
"last_page": 10,
"first_page": 1,
"page_count": 42,
"selected_page": 1,
"show_pagination": true
},
"total_results": null
},
"status": "success"
}
}About the mercadolibre.com.ar 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.
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.
- 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 | 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 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.