# Mercado Livre Offers Scraper (x402)

> Mercado Livre Offers Scraper (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.04/call, status unknown (last checked 2026-10-02).

Scrapes structured product offer listings from Mercado Livre Brazil pages, returning titles, prices, IDs, and permalinks with pay-per-call USDC billing.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/mercado?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mercado-livre-offers-scraper-x402-83f264db
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nM1W3O-4b7xyGcq2D0R5a

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability mercado-livre-offers-scraper-x402-83f264db -d '<json body>'
```

Example prompt: Scrape Mercado Livre Brazil for smartphone listings under R$2000 — sort by price ascending, grab up to 50 items from the first 3 pages, and only include official store offers. Start from the electronics offers page at https://www.mercadolivre.com.br/ofertas.

## When to prefer this

Choose this endpoint when you need structured product offer data specifically from Mercado Livre Brazil (mercadolivre.com.br) — especially when you want price filtering, official store filtering, or sorted listings without paying for failed or empty runs. Prefer it over generic web scrapers when you need clean, schema-consistent output (title, price, IDs, permalink) from Brazilian marketplace offer pages.

## Known failure modes

- Mercado Livre serves a verification challenge page — endpoint returns empty or no charge is incurred
- URL points to a non-offers page type — results will be empty
- priceMin/priceMax filters too narrow — returns zero items but no charge
- maxPagesPerQuery exceeds 21-page site limit — capped at 21
- searchQueries terms don't match any visible titles on crawled pages — empty result set
- Rate limiting or temporary block by Mercado Livre — empty run, no charge

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

A JSON object containing a count of matched items and an array of offer records, each with title, price, item ID, site ID, permalink, canonical URL, and catalog product ID. Fields may be null if not present on the page.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "enum": [
    "relevance",
    "price_asc",
    "price_desc"
   ],
   "type": "string",
   "default": "relevance",
   "description": "Order the collected offers by page order or price. Price sorting applies to the crawled pages."
  },
  "maxItems": {
   "type": "integer",
   "default": 50,
   "minimum": 0,
   "description": "Maximum number of dataset rows. Set to 0 to collect all matches from the page limit."
  },
  "priceMax": {
   "type": "number",
   "minimum": 0,
   "description": "Keep offers at or below this price in Brazilian reais."
  },
  "priceMin": {
   "type": "number",
   "minimum": 0,
   "description": "Keep offers at or above this price in Brazilian reais."
  },
  "startUrls": {
   "type": "array",
   "description": "Public Brazil offers pages to crawl. Use the general offers page or an offers URL with a category filter. Other page types currently return verification challenges."
  },
  "searchQueries": {
   "type": "array",
   "description": "Optional product title terms. Each phrase is matched against the offers pages being crawled; this is not a full marketplace search."
  },
  "maxPagesPerQuery": {
   "type": "integer",
   "default": 3,
   "maximum": 21,
   "minimum": 1,
   "description": "Number of offers pages to scan per URL, up to the site's observed 21-page limit."
  },
  "officialStoresOnly": {
   "type": "boolean",
   "default": false,
   "description": "Keep cards visibly marked as official stores."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "id": null,
    "price": null,
    "title": null,
    "itemId": null,
    "siteId": null,
    "permalink": null,
    "canonicalUrl": null,
    "catalogProductId": null
   }
  ],
  "product": "mercado"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mercado-livre-offers-scraper-x402-83f264db/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)