# Mercado Livre Product

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/mercado/product` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/mercado-product |

## Description

Fetch a full Mercado Livre Brazil product listing by URL or item ID and get price, description, variants, seller reputation, installments, and reviews as structured JSON.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/mercado/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### iPhone 14 128GB product page

```json
{
  "id": "MLB3619890194",
  "url": "https://www.mercadolivre.com.br/apple-iphone-14-128-gb-preto/p/MLB20505848",
  "price": 3799.99,
  "title": "Apple iPhone 14 (128 GB) - Preto",
  "rating": {
    "total": 5312,
    "average": 4.8,
    "breakdown": {
      "1": 44,
      "2": 48,
      "3": 110,
      "4": 620,
      "5": 4490
    }
  },
  "seller": {
    "id": 223890471,
    "nickname": "APPLE_OFICIAL_BR",
    "reputation_level": "platinum",
    "is_official_store": true,
    "transactions_completed": 58420,
    "positive_feedback_percent": 98.7
  },
  "pictures": [
    "https://http2.mlstatic.com/D_NQ_NP_773843-MLB72205109484_102023-F.jpg",
    "https://http2.mlstatic.com/D_NQ_NP_894031-MLB72205118392_102023-F.jpg"
  ],
  "shipping": {
    "mode": "me2",
    "tags": [
      "fulfillment",
      "mandatory_free_shipping"
    ],
    "free_shipping": true,
    "store_pick_up": false
  },
  "condition": "new",
  "video_url": null,
  "attributes": [
    {
      "id": "BRAND",
      "name": "Marca",
      "value_name": "Apple"
    },
    {
      "id": "MODEL",
      "name": "Modelo",
      "value_name": "iPhone 14"
    },
    {
      "id": "STORAGE_CAPACITY",
      "name": "Capacidade de armazenamento",
      "value_name": "128 GB"
    },
    {
      "id": "OPERATING_SYSTEM",
      "name": "Sistema operacional",
      "value_name": "iOS"
    },
    {
      "id": "DISPLAY_SIZE",
      "name": "Tamanho da tela",
      "value_name": "6.1 \""
    },
    {
      "id": "RAM",
      "name": "Memória RAM",
      "value_name": "6 GB"
    }
  ],
  "variations": [
    {
      "id": 174482808549,
      "price": 3799.99,
      "thumbnail": "https://http2.mlstatic.com/D_NQ_NP_773843-MLB72205109484_102023-O.webp",
      "available_quantity": 312,
      "attribute_combinations": [
        {
          "name": "Cor",
          "value_name": "Preto"
        },
        {
          "name": "Capacidade de armazenamento",
          "value_name": "128 GB"
        }
      ]
    }
  ],
  "buying_mode": "buy_it_now",
  "category_id": "MLB1055",
  "currency_id": "BRL",
  "description": "O iPhone 14 apresenta um novo design de câmera traseira com sensor principal de 12 MP e abertura f/1.5, gravação de vídeo em 4K, chip A15 Bionic, tela Super Retina XDR de 6,1 polegadas e autonomia de até 20 horas de reprodução de vídeo.",
  "date_created": "2022-09-16T14:00:00.000Z",
  "installments": {
    "rate": 0,
    "amount": 316.67,
    "quantity": 12
  },
  "last_updated": "2026-04-28T08:12:00.000Z",
  "category_path": [
    "Celulares e Smartphones",
    "Apple",
    "iPhone 14"
  ],
  "sold_quantity": 12430,
  "original_price": 4499,
  "listing_type_id": "gold_special",
  "available_quantity": 850,
  "discount_percentage": 15.5
}
```

## Documentation

## Overview

Mercado Livre applies Cloudflare bot protection on every product page. Getting structured product data programmatically requires bypassing Cloudflare, rotating proxies, and parsing dynamic HTML. Piloterr handles all of this transparently. One GET request with an item URL or ID returns the full product sheet: price, all variants, seller trust signals, shipping details, and rating breakdown.

## Quickstart

```
GET https://api.piloterr.com/v2/mercado/product?query=MLB3619890194
```

## Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Product URL or Mercado Livre item ID |

## Main use cases

- Enrich a product catalog with live Mercado Livre price, discount, and instalment information
- Monitor competitor product pages for price changes and stock depletion
- Verify seller reputation before initiating a supplier or resale relationship
- Build a product detail page for a comparison platform aggregating Brazilian marketplace data
- Feed a pricing model with live variant-level data across multiple SKUs