# Mercadolivre — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access real-time product data from Brazil's largest online marketplace, including daily deals, best sellers, category listings, search suggestions, and supermarket products. Integrate Mercado Livre shopping information directly into your applications to power price comparisons, product discovery, and market research.

**Category:** E-commerce | **Website:** [mercadolivre.com.br/](https://mercadolivre.com.br/) | **Docs:** [parse.bot/marketplace/5b535d41-078d-417b-8062-a857d29ab66b/mercadolivre-com-br-api](https://parse.bot/marketplace/5b535d41-078d-417b-8062-a857d29ab66b/mercadolivre-com-br-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-mercadolivre-com-br-api-5b535d41/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_best_sellers

Retrieve best-selling products across all categories from Mercado Livre. Returns a ranked list of top-selling items with prices, images, and discount information. Rankings are updated frequently based on sales volume.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mercadolivre-com-br-api-5b535d41/get_best_sellers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_daily_deals

Retrieve current daily deals (Ofertas do dia) from Mercado Livre. Returns a list of discounted products with prices, discount percentages, product URLs, and seller information. The deals rotate daily and reflect time-limited promotions.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mercadolivre-com-br-api-5b535d41/get_daily_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_search_suggestions

Get autocomplete search suggestions for a query prefix. Returns a list of suggested search queries based on the input, useful for building search-as-you-type interfaces or discovering popular search terms.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query prefix for autocomplete suggestions. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mercadolivre-com-br-api-5b535d41/get_search_suggestions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### get_supermarket_products

Browse products in the Supermercado (supermarket) section of Mercado Livre. Returns grocery and household items with prices, images, and shipping information. Products reflect the current supermarket catalog.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mercadolivre-com-br-api-5b535d41/get_supermarket_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_categories

List all top-level product categories available on Mercado Livre. Returns category names, URLs, and category IDs. Categories are stable and represent the marketplace's main product taxonomy.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mercadolivre-com-br-api-5b535d41/list_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```