mercadolivre.com.br
Mercado Livre API
Query public Mercado Livre data with GeckoAPI and receive structured JSON. Choose an operation to review its inputs, credit cost and response fields.
Search by keyword, category, best sellers and offers from Mercado Livre, with filters and pagination.
GeckoAPI is independent of Mercado Livre. This integration reads public data; it does not grant access to private accounts or account management operations.
Available operations
Search products
mercadolivre.com.br:plp
Search by keyword, category, best sellers and offers from Mercado Livre, with filters and pagination.
1 credit per request
Get product details
mercadolivre.com.br:pdp
Query price, stock and seller in PDP of Mercado Livre, with optional CEP and indication of replaced product or offer.
1 credit per request
Read reviews
mercadolivre.com.br:review
Extracts product reviews in Mercado Livre with pagination.
1 credit per request
These are standard credit costs. Account-specific pricing is shown in the dashboard. Each operation has its own supported inputs and regional coverage.
Coverage and limitations
Use keyword or a listing URL for search. Pages start at 1. Send the selected product URL to PDP. Optional zipCode supplies shipping context. Prices use BRL; missing stock, seller and shipping fields must remain unknown. This API reads public pages and does not manage seller accounts or orders.
Make your first request
The example uses search products. Replace YOUR_API_KEY with your server-side API key. Copy supported inputs from the reference for the operation you choose.
curl -X POST https://api.geckoapi.com.br/v1/extract \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://lista.mercadolivre.com.br/iphone-15-pro-max",
"target": "mercadolivre.com.br",
"type": "plp",
"page": 2
}'Example JSON response
Abbreviated example from the same operation. Arrays and nested objects are shortened here; the endpoint reference includes the full documented schema. Source content retains its original language.
{
"requestId": "22222222-1111-4111-8111-222222222222",
"executionId": "22222222-2222-4222-8222-222222222222",
"data": {
"source": "mercadolivre.com.br",
"type": "plp",
"url": "https://lista.mercadolivre.com.br/iphone-15-pro-max",
"requestUrl": "https://lista.mercadolivre.com.br/iphone-15-pro-max",
"extractedAt": "2026-02-12T12:34:56.000Z",
"query": "iphone 15 pro max",
"totalResults": 4832,
"primaryResults": 1000,
"page": 2,
"resultsPerPage": 48,
"offset": 48,
"nextPage": 3,
"nextPageUrl": "https://lista.mercadolivre.com.br/iphone-15-pro-max?_Desde=97",
"items": [
{
"url": "https://www.mercadolivre.com.br/p/MLB3889019023",
"imageUrl": "https://http2.mlstatic.com/D_Q_NP_2X_654321-MLB3889019023_082026-E.webp",
"sku": "MLB3889019023",
"categoryId": "MLB1055",
"domainId": "MLB-CELLPHONES",
"name": "Apple iPhone 15 Pro Max 256GB Titanio Natural",
"condition": "new",
"currency": "BRL",
"currencyRaw": "R$",
"price": 8499,
"highlight": "MAIS VENDIDO",
"isBestSeller": true,
"isPowerSeller": true,
"powerSellerStatusTitle": "platinum",
"aggregateRating": {
"rating": 4.8,
"reviewCount": 1250
},
"ean": "194253952768",
"sellerId": "123456789",
"sellerName": "Apple Store Oficial"
}
],
"categories": [
{
"id": "MLB1051",
"name": "Celulares e Telefones",
"url": "https://lista.mercadolivre.com.br/celulares-telefones/"
}
],
"breadcrumbs": [
{
"name": "Celulares e Telefones",
"url": "https://www.mercadolivre.com.br/c/celulares-e-telefones"
}
],
"availableFilters": [],
"appliedFilters": []
}
}Integrate with REST or MCP
Call POST /v1/extract from your backend, or use the operation-specific tool on POST /v1/mcp. The API reference includes both request formats. Keep credentials in your backend and handle missing fields, pagination and errors according to that operation's rules.
Ready to test the Mercado Livre API?
Open the documented example in the sandbox and inspect the response before integrating it into your application.