autos.mercadolibre.com.ar APIautos.mercadolibre.com.ar ↗
Search and retrieve car listings from MercadoLibre Argentina. Get title, brand, model, year, km, price, location, seller type, and image URL.
curl -X GET 'https://api.parse.bot/scraper/5361fcb5-518a-495a-bba6-5a78f0038d7c/search_cars?page=2&limit=10&query=ford-focus' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for car listings on MercadoLibre Argentina. Returns structured data for each listing including title, brand, model, year, kilometers, price, currency, location, seller type, and main image URL. Results are paginated with up to 48 listings per page.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-based). |
| limit | integer | Maximum number of listings to return per page (max 48). |
| query | string | Search query with words separated by hyphens or spaces (e.g., 'toyota-hilux-2020', 'ford-ranger', 'volkswagen-amarok-2022'). |
{
"type": "object",
"fields": {
"page": "integer - current page number",
"count": "integer - number of listings returned on this page",
"query": "string - the search query used",
"listings": "array of listing objects with id, title, brand, model, year, km, price_original, currency, location, seller_type, image_url, url, category_id",
"total_pages": "integer - total number of pages",
"total_results": "integer - total number of results available"
},
"sample": {
"data": {
"page": 1,
"count": 10,
"query": "toyota-hilux-2020",
"listings": [
{
"id": "MLA3294165114",
"km": 105000,
"url": "https://auto.mercadolibre.com.ar/MLA-3294165114-toyota-hilux-pick-up-40-v6-gr-s-ii-4x4-6at-_JM",
"year": 2020,
"brand": "Toyota",
"model": "Hilux",
"title": "Toyota Hilux Pick-up 4.0 V6 Gr-s Ii 4x4 6at",
"currency": "USD",
"location": "General San Martín - Bs.As. G.B.A. Norte",
"image_url": "https://http2.mlstatic.com/D_NQ_NP_709112-MLA106797915220_022026-O.jpg",
"category_id": "MLA1744",
"seller_type": "private",
"price_original": 45000
}
],
"total_pages": 3,
"total_results": 121
},
"status": "success"
}
}About the autos.mercadolibre.com.ar API
The MercadoLibre Argentina Cars API provides access to vehicle listings from autos.mercadolibre.com.ar through a single search_cars endpoint that returns up to 12 structured fields per listing — including brand, model, year, kilometers, price with currency, seller type, and location. Each response includes pagination metadata covering total results and total pages, making it straightforward to traverse large result sets across Argentina's most active online car marketplace.
What the API Returns
The search_cars endpoint returns an array of listing objects, each containing: id, title, brand, model, year, km, price_original, currency, location, seller_type, image_url, and url. At the response level, page, count, query, total_pages, and total_results give you the context needed to paginate through full result sets. Currency is returned alongside price so your application can handle ARS and USD listings without ambiguity.
Query and Pagination Parameters
The query parameter accepts hyphen- or space-separated terms (e.g., toyota-hilux-2020 or ford-ranger), making it easy to target a specific make, model, or year combination. Pagination is controlled by page (1-based integer) and limit (up to 48 listings per page). Together these let you scan hundreds of results programmatically — useful for price surveys or inventory snapshots across a specific segment like pickup trucks or compact sedans.
Seller and Location Data
Each listing includes a seller_type field that distinguishes between individual sellers and dealerships, and a location field that reflects the geographic area of the listing within Argentina. These two fields are particularly useful when building regional price-comparison tools or filtering results to specific provinces and city areas.
Source Coverage
MercadoLibre Argentina is one of the highest-volume used and new car marketplaces in the country. The API covers the public search surface for vehicle listings. Data points like full seller contact details, extended vehicle specifications, or financing options are not part of the current response schema.
- Track price trends for a specific make/model/year combination over time using
price_originalandcurrency - Compare asking prices between individual sellers and dealerships using the
seller_typefield - Build a regional price map of Argentine car listings using the
locationfield - Monitor new listings for a target vehicle segment by polling
search_carswith a specificquery - Aggregate mileage distributions for a model using the
kmfield across paginated results - Populate a car valuation tool with live market comps from MercadoLibre Argentina listings
- Identify the most-listed brands and models in a given price range by analyzing
brandandprice_original
| 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?+
What does the `search_cars` endpoint return for each listing?+
id, title, brand, model, year, km, price_original, currency, location, seller_type, image_url, and url. The response envelope also provides page, count, total_pages, and total_results for pagination.How does pagination work and what is the maximum page size?+
page parameter is 1-based. The limit parameter caps at 48 listings per page. The response includes total_results and total_pages so you can determine how many pages to iterate. If you request a page beyond total_pages, the count will be zero.Does the API return detailed vehicle specifications such as engine size, transmission, or fuel type?+
Can I filter results by price range, year, or kilometers directly?+
query string parameter, which accepts keyword terms like make, model, and year. Price range, maximum km, and year-range filters are not separate input parameters at this time. You can fork this API on Parse and revise it to add those filter parameters as additional inputs to the search_cars endpoint.