Mercado Livre Brazil: get product details
Inspect one public product page for pricing, identity, images and other fields when available from the source.
1 credits per request. Public data only; GeckoAPI is independent of the marketplace.
Try this endpointRegion, pagination 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.
HTTP request
cURL
curl -X POST https://api.geckoapi.com.br/v1/extract \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://produto.mercadolivre.com.br/MLB-4196330777-acrilico-toque-de-seda-premium-leve-brilho-16l-suvinil-_JM",
"target": "mercadolivre.com.br",
"type": "pdp"
}'Replace YOUR_API_KEY with your own server-side credential. Read the quickstart for authentication and error handling.
Supported inputs
| Field | Requirement | Meaning |
|---|---|---|
| url | required | Complete public search or product URL. Keep its country and query parameters. |
| zipCode | optional | Brazilian destination postal code for shipping context. |
| target | required | Source identifier shown in the example. |
| type | required | plp for search; pdp for product details. |
Conditional means an alternative input can satisfy the request, such as keyword or search URL. Fields absent from this table are unsupported for this endpoint.
Example response
One possible response, not a guarantee of current price or availability. Product text stays in the source language. Fields may be missing or null; preserve that distinction in your database.
JSON
{
"requestId": "11111111-1111-4111-8111-111111111111",
"executionId": "11111111-2222-4222-8222-111111111111",
"data": {
"isInternational": false,
"variants": [
"https://produto.mercadolivre.com.br/MLB-4196330777-acrilico-toque-de-seda-premium-leve-brilho-16l-suvinil-_JM"
],
"cashPrice": 620.21,
"canonicalUrl": "https://produto.mercadolivre.com.br/MLB-4196330777-acrilico-toque-de-seda-premium-leve-brilho-16l-suvinil-_JM",
"price": 620.21,
"additionalProperties": [
{
"name": "Marca",
"value": "Suvinil"
}
],
"regularPrice": 689,
"sellerName": "Loja Oficial RN",
"sellerLevel": "5_green",
"freeShipping": true,
"itemCondition": "new",
"stockQuantity": 7,
"images": [
{
"url": "https://http2.mlstatic.com/D_NQ_NP_904711-MLB91911673092_092025-O.webp"
}
],
"brand": {
"name": "Suvinil"
},
"sellerType": "brand",
"soldCount": 42,
"shippingFee": 15.99,
"shippingEstimatedDeliveryText": "Chegara domingo",
"shippingEstimatedDeliveryTimeMinDays": 2,
"shippingEstimatedDeliveryTimeMaxDays": 2,
"shippingDestinationZipCode": "01001000",
"aggregateRating": {
"ratingValue": 4.8,
"reviewCount": 125,
"bestRating": 5
},
"currency": "BRL",
"currencyRaw": "R$",
"breadcrumbs": [
{
"name": "Construcao",
"url": "https://www.mercadolivre.com.br/c/construcao"
}
],
"description": "Tinta acrilica premium com acabamento acetinado.",
"mainImage": {
"url": "https://http2.mlstatic.com/D_NQ_NP_904711-MLB91911673092_092025-O.webp"
},
"sku": "MLB-4196330777",
"availability": "InStock",
"isFullDelivery": true,
"name": "Acrilico Toque de Seda Premium 16L",
"url": "https://produto.mercadolivre.com.br/MLB-4196330777-acrilico-toque-de-seda-premium-leve-brilho-16l-suvinil-_JM",
"otherSellers": [
{
"sellerName": "Casa da Tinta",
"price": 629.9,
"sellerUrl": "https://lista.mercadolivre.com.br/?seller_id=123456",
"sellerId": "123456",
"reputationLevel": "5_green",
"powerSellerStatusTitle": "gold"
}
],
"sellerId": "1006734354",
"powerSellerStatusTitle": "platinum",
"sellerUrl": "https://lista.mercadolivre.com.br/?seller_id=1006734354",
"installmentPrice": "719.64",
"installmentCount": 12,
"itemId": null,
"userProductId": null,
"familyId": null,
"installmentOptions": [
{
"paymentMethodId": null,
"issuer": null,
"count": 12,
"amount": null,
"total": 719.64,
"interestFree": null,
"meliplusInstallments": null,
"additionalBankInterest": null,
"rank": null
}
],
"variantOptions": []
}
}Response fields
Field paths and types
{
"requestId": "string (uuid)",
"executionId": "string (uuid)",
"notFound": "boolean (optional; true when the upstream entity was not found and data is null)",
"data.isInternational": "boolean",
"data.variants[]": "string",
"data.cashPrice": "number",
"data.canonicalUrl": "string",
"data.price": "number",
"data.additionalProperties[].name": "string",
"data.additionalProperties[].value": "string",
"data.regularPrice": "number",
"data.sellerName": "string",
"data.sellerLevel": "string",
"data.freeShipping": "boolean",
"data.itemCondition": "string",
"data.stockQuantity": "number",
"data.images[].url": "string",
"data.brand.name": "string",
"data.sellerType": "string",
"data.soldCount": "number",
"data.shippingFee": "number",
"data.shippingEstimatedDeliveryText": "string",
"data.shippingEstimatedDeliveryTimeMinDays": "number",
"data.shippingEstimatedDeliveryTimeMaxDays": "number",
"data.shippingDestinationZipCode": "string",
"data.aggregateRating.ratingValue": "number",
"data.aggregateRating.reviewCount": "number",
"data.aggregateRating.bestRating": "number",
"data.currency": "string",
"data.currencyRaw": "string",
"data.breadcrumbs[].name": "string",
"data.breadcrumbs[].url": "string",
"data.description": "string",
"data.mainImage.url": "string",
"data.sku": "string",
"data.availability": "string",
"data.isFullDelivery": "boolean",
"data.name": "string",
"data.url": "string",
"data.otherSellers[].sellerName": "string",
"data.otherSellers[].price": "number",
"data.otherSellers[].sellerUrl": "string",
"data.otherSellers[].sellerId": "string",
"data.otherSellers[].reputationLevel": "string",
"data.otherSellers[].powerSellerStatusTitle": "string",
"data.sellerId": "string",
"data.powerSellerStatusTitle": "string",
"data.sellerUrl": "string",
"data.installmentPrice": "string",
"data.installmentCount": "number",
"data.itemId": "string | null (optional)",
"data.userProductId": "string | null (optional)",
"data.familyId": "string | null (optional)",
"data.installmentOptions[].paymentMethodId": "string | null",
"data.installmentOptions[].issuer": "string | null",
"data.installmentOptions[].count": "integer | null",
"data.installmentOptions[].amount": "number | null",
"data.installmentOptions[].total": "number | null",
"data.installmentOptions[].interestFree": "boolean | null",
"data.installmentOptions[].meliplusInstallments": "boolean | null",
"data.installmentOptions[].additionalBankInterest": "boolean | null",
"data.installmentOptions[].rank": "number | null",
"data.variantOptions[].attributeId": "string | null (optional)",
"data.variantOptions[].label": "string | null (optional)",
"data.variantOptions[].selectedProductId": "string | null (optional)",
"data.variantOptions[].selectedValue": "string | null (optional)",
"data.variantOptions[].selectionPrompt": "string | null (optional)",
"data.variantOptions[].options[].productId": "string | null (optional)",
"data.variantOptions[].options[].attributeValueId": "string | null (optional)",
"data.variantOptions[].options[].value": "string | null (optional)",
"data.variantOptions[].options[].url": "string | null (optional)",
"data.variantOptions[].options[].selected": "boolean | null (optional)",
"data.variantOptions[].options[].decorationType": "string | null (optional)",
"data.variantOptions[].options[].availabilityText": "string | null (optional)",
"data.variantOptions[].options[].price": "number | null (optional)",
"data.variantOptions[].options[].regularPrice": "number | null (optional)",
"data.variantOptions[].options[].currency": "string | null (optional)",
"data.variantOptions[].options[].pictureId": "string | null (optional)",
"data.variantOptions[].options[].thumbnailUrl": "string | null (optional)",
"data.variantOptions[].options[].measurementsText": "string | null (optional)",
"data.variantOptions[].options[].requiredAttributes[]": "string (optional)",
"data.installmentOptions": "array (optional)",
"data.variantOptions": "array (optional)"
}