# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/mercado-libre-argentina/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/mercado-libre-argentina/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/mercado-libre-argentina/get-product-reviews \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/mercado-libre-argentina/get-seller-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/mercado-libre-argentina/search-cars \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/mercado-libre-argentina/search-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/mercado-libre-argentina/search-real-estate \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","operation":"<string>","property_type":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.