Com APIautos.mercadolibre.com.ar ↗
Search and retrieve car listings from MercadoLibre Argentina. Get brand, model, year, km, price, currency, location, seller type, and image URL per listing.
What is the Com 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 48 structured listings per page. Each result includes 12 data fields covering vehicle attributes such as brand, model, year, mileage, price, currency, location, seller type, and image URL, along with pagination metadata for iterating across the full result set.
curl -X GET 'https://api.parse.bot/scraper/5361fcb5-518a-495a-bba6-5a78f0038d7c/search_cars?page=1&limit=10&query=toyota-hilux' \ -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 autos-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 car listings SDK — bounded, re-runnable."""
from parse_apis.mercadolibre_argentina_car_listings_api import MercadoLibre, SearchFailed
client = MercadoLibre()
# Search for Toyota Hilux listings, capped at 5 total items.
for listing in client.listings.search(query="toyota-hilux", limit=5):
print(listing.title, listing.year, listing.price_original, listing.currency)
# Drill-down: take one Ford Ranger listing.
ranger = client.listings.search(query="ford-ranger", limit=1).first()
if ranger:
print(ranger.id, ranger.brand, ranger.model, ranger.km, ranger.location)
# Typed error handling around a search call.
try:
result = client.listings.search(query="volkswagen-amarok", limit=3).first()
if result:
print(result.title, result.seller_type, result.image_url)
except SearchFailed as exc:
print(f"search failed: {exc}")
print("exercised: listings.search (toyota-hilux / ford-ranger / volkswagen-amarok)")
Full-text search over MercadoLibre Argentina car listings. query matches vehicle makes, models, and years; results include price, mileage, location, and seller info. Paginates server-side at 48 items per page. Each listing carries an id, title, brand (first word of title), model (second word), year, km, price_original, currency (USD or ARS), location, seller_type (private, dealer, official_store), image_url, url, and category_id.
| 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', 'ford-ranger', 'volkswagen-amarok'). |
{
"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",
"listings": [
{
"id": "MLA1825567681",
"km": 187000,
"url": "https://auto.mercadolibre.com.ar/MLA-1825567681-toyota-hilux-sw4-tdi-srx-aut-l16-blindada-rb3-_JM",
"year": 2019,
"brand": "Toyota",
"model": "Hilux",
"title": "Toyota Hilux Sw4 Toyota Hilux Sw4 Tdi Srx Aut L/16 Blindado Rb3",
"currency": "USD",
"location": "Capital Federal - Capital Federal",
"image_url": "https://http2.mlstatic.com/D_NQ_NP_726012-MLA106327140605_012026-O.jpg",
"category_id": "MLA1744",
"seller_type": "private",
"price_original": 42000
}
],
"total_pages": 42,
"total_results": 2000
},
"status": "success"
}
}About the Com API
What the API Returns
The search_cars endpoint accepts a query string — vehicle brand, model, and year terms joined by hyphens or spaces (e.g., toyota-hilux, ford-ranger) — and returns an array of Listing objects. Each listing carries a unique id, title, brand, model, year, km, price_original, currency, location, seller_type, image_url, and a direct url to the listing on MercadoLibre Argentina.
Pagination and Result Counts
The response includes total_results (total matching listings in the index) and total_pages alongside the current page and count (listings on this page). Use the page parameter (1-based) to walk through result sets, and the optional limit parameter to cap how many listings come back per request (maximum 48). A query for a popular model like toyota-hilux-2020 may return thousands of results across many pages.
Seller and Location Fields
The seller_type field distinguishes between individual sellers and dealerships, which matters for market analysis and lead qualification. The location field reflects the Argentine province or city associated with the listing, enabling regional price comparisons. The currency field captures whether the price is quoted in Argentine pesos (ARS) or US dollars (USD), which is common in the Argentine used-car market.
Query Behavior
The query parameter maps to brand, model, and year terms as they appear in MercadoLibre Argentina's vehicle category. Searches are not case-sensitive, and hyphen-separated terms (volkswagen-amarok-2019) work the same as space-separated terms. There is no separate filter parameter for year, fuel type, or transmission — filtering by these attributes requires including them in the query string or post-processing results using the year and km fields returned per listing.
The Com API is a managed, monitored endpoint for autos.mercadolibre.com.ar — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when autos.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 autos.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?+
- Track price trends for a specific make, model, and year (e.g., Toyota Hilux 2020) across multiple pages of listings.
- Compare asking prices between individual sellers and dealerships using the
seller_typefield. - Build a regional price map of used cars across Argentine provinces using the
locationfield. - Identify mileage-to-price ratios for a vehicle model by correlating
kmandprice_originalacross listings. - Monitor new listings for a target vehicle by polling
search_carsand diffingidvalues over time. - Detect whether listings are priced in ARS or USD using the
currencyfield for currency-aware price normalization. - Feed listing URLs and images into a vehicle comparison tool using the
urlandimage_urlfields.
| 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?+
What does the `seller_type` field contain, and how specific is it?+
seller_type field indicates whether the listing was posted by an individual (private seller) or a dealership/professional seller. It does not return a seller name, contact details, or seller rating. Those fields are not currently exposed. You can fork this API on Parse and revise it to add the missing endpoint if you need seller profile data.Can I filter listings by year, price range, or mileage directly in the request?+
search_cars endpoint accepts a query string and page/limit pagination parameters only. Filtering by year, price range, or mileage must be done by including terms in the query string (e.g., toyota-hilux-2020) or by filtering the returned year, price_original, and km fields client-side. You can fork this API on Parse and revise it to add dedicated filter parameters.