# Mercado Libre Argentina — 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.

> Search for products, cars, and real estate listings on MercadoLibre Argentina and access detailed information including product specifications, customer reviews, and seller profiles. Get comprehensive market data to compare prices, evaluate sellers, and make informed purchasing decisions across multiple categories.

**Category:** Marketplaces | **Website:** [mercadolibre.com.ar/](https://mercadolibre.com.ar/) | **Docs:** [parse.bot/marketplace/f80d4e92-b3cb-4c60-a85b-d7ee800233a3/mercadolibre-com-ar-api](https://parse.bot/marketplace/f80d4e92-b3cb-4c60-a85b-d7ee800233a3/mercadolibre-com-ar-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-mercadolibre-com-ar-api-f80d4e92/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_product_details

Get detailed information for a specific product item including description, images, seller info, and attributes. Requires a valid MercadoLibre item ID.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | MercadoLibre item ID (e.g. 'MLA1424712885', 'MLA1549629507') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mercadolibre-com-ar-api-f80d4e92/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_id":"<string>"}'
```

### get_product_reviews

Get customer reviews for a specific product. Returns review text, ratings, and overall averages when available. Not all products have reviews.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | MercadoLibre item ID (e.g. 'MLA1424712885') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mercadolibre-com-ar-api-f80d4e92/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_id":"<string>"}'
```

### get_seller_profile

Get seller reputation and status info by providing any item ID from that seller. Returns the seller's name, numeric ID, reputation level, and detailed status information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | Any MercadoLibre item ID from the seller (e.g. 'MLA1424712885') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mercadolibre-com-ar-api-f80d4e92/get_seller_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_id":"<string>"}'
```

### search_cars

Search for car and vehicle listings on MercadoLibre Argentina. At least one of brand or query should be provided. Returns listings with year, kilometers, and location when available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand` | string | No | Car brand (e.g. 'Toyota', 'Ford', 'Chevrolet') |
| `model` | string | No | Car model (e.g. 'Corolla', 'Focus'). Used in combination with brand. |
| `query` | string | No | Additional search keywords (e.g. 'auto usado') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mercadolibre-com-ar-api-f80d4e92/search_cars \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand":"<string>","model":"<string>","query":"<string>"}'
```

### search_listings

Search for product listings on MercadoLibre Argentina. Returns paginated results with items including price, title, and shipping info. Each page yields approximately 48 results. Pagination is offset-based with increments visible in the returned pagination_nodes_url.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category slug to narrow search results (e.g. 'computacion') |
| `offset` | integer | No | Results offset for pagination. Each page contains approximately 48 results. |
| `query` | string | Yes | Search keywords (e.g. 'notebook', 'celular', 'zapatillas') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mercadolibre-com-ar-api-f80d4e92/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","offset":"<integer>","query":"<string>"}'
```

### search_real_estate

Search for real estate listings on MercadoLibre Argentina. Returns properties filtered by operation type and property type. At least one result is expected for common queries.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | Location filter (e.g. 'Palermo', 'Buenos-Aires') |
| `operation` | string | No | Operation type: 'venta' or 'alquiler' |
| `property_type` | string | No | Property type: 'casas', 'departamentos', or 'terrenos' |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mercadolibre-com-ar-api-f80d4e92/search_real_estate \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","operation":"<string>","property_type":"<string>"}'
```