# brmarket Brazilian Marketplace Product Search

> brmarket Brazilian Marketplace Product Search is a paid API for AI agents from brmarket.thomenz.me, paid per call via x402, $0.04/call, status unknown (last checked 2026-09-15).

Search and compare product prices across Brazilian marketplaces (Mercado Livre, Shopee, AliExpress) returning normalized BRL prices in integer cents, canonical URLs, and affiliate links in a single call.

## Facts

- Endpoint: POST https://brmarket.thomenz.me/v1/compare
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brmarket-brazilian-marketplace-product-search-d802815d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZKJ1xgaQeEV5XLbE7eSze

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 brmarket-brazilian-marketplace-product-search-d802815d -d '<json body>'
```

Example prompt: Can you compare prices for the Sony WH-1000XM5 headphones across Mercado Livre, Shopee, and AliExpress right now, including any import taxes, and show me the cheapest option with an affiliate link?

## When to prefer this

Choose this endpoint when you need real-time, cross-marketplace price comparison specifically for Brazilian e-commerce platforms (Mercado Livre, Shopee, AliExpress) with BRL pricing, affiliate links, and import tax estimates in a single normalized call. It is especially valuable when you need match confidence scoring to verify a product listing corresponds to a specific model or MPN, or when you want landed price estimates that include Brazilian import duties. Prefer this over generic web search when you need structured, machine-readable pricing data rather than scraped HTML.

## Known failure modes

- Marketplace not configured (e.g. Shopee returns 'not_configured' status)
- No results found for obscure or misspelled product queries
- Low match confidence scores for generic query strings
- Import tax estimates may be inaccurate for certain product categories
- Affiliate links may expire or become invalid over time
- Payment failure via x402 protocol if USDC balance is insufficient
- Rate limits or marketplace-side blocking causing partial results

## How this service works

Paste a product URL from ANY store; the API identifies the product and returns the same or equivalent item CHEAPER across Mercado Livre, Shopee and AliExpress. Each candidate carries a `match_confidence` (no cross-marketplace barcode exists, so a match is never claimed identical) and a landed-price estimate (import tax included for international offers, labeled). Our marketplaces resolve by API; other stores via a page read that falls back to the URL text.

## Output

A JSON object containing: total result count, the reference source product (if provided), an array of marketplace results each with price in BRL integer cents, product title, seller details, rating, sold count, affiliate URL, match confidence level and score, import tax flag, original price, landed price estimate, savings vs source, and a per-marketplace status object indicating whether each marketplace (Shopee, AliExpress, Mercado Livre) was queried successfully or not configured. Also includes a data_as_of timestamp and a disclaimer about price volatility.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "query": "novadigital mpn 10 painel central inteligente maxpanel",
  "source": {
   "url": "https://www.magazineluiza.com.br/painel-central-inteligente-maxpanel-novadigital/p/ad3g3a21d1/",
   "brand": "Novadigital",
   "model": "MPN-10",
   "title": "Painel Central Inteligente Maxpanel - Novadigital MPN-10",
   "priceCents": 250268,
   "marketplace": "magazineluiza",
   "resolved_via": "gemini"
  },
  "compare": true,
  "results": [
   {
    "url": "https://www.aliexpress.com/item/1005011820157510.html",
    "title": "Novadigital MaxPanel MPN-10 Zigbee Smart Home Control Panel",
    "origin": "international",
    "rating": 4.85,
    "seller": {
     "id": "1105334068",
     "name": "Shop1105334068 Store",
     "officialStore": false
    },
    "dataAsOf": "2026-07-17T13:30:34.360Z",
    "imageUrl": "https://ae-pic-a1.aliexpress-media.com/kf/S9797cb68d7f54af6a1e0544043443f47J.jpg",
    "productId": "1005011820157510",
    "soldCount": 84,
    "priceCents": 187848,
    "marketplace": "aliexpress",
    "affiliateUrl": "https://s.click.aliexpress.com/e/_c2ROmufZ",
    "savings_cents": 13379,
    "shippingCents": 1285,
    "deliveryDaysMax": 19,
    "shipFromCountry": "CN",
    "match_confidence": {
     "level": "high",
     "score": 0.82
    },
    "import_tax_applied": true,
    "originalPriceCents": 20270,
    "cheaper_than_source": true,
    "landed_price_estimate": 236889
   }
  ],
  "sources": {
   "shopee": "not_configured",
   "aliexpress": "ok",
   "mercadolivre": "ok"
  },
  "data_as_of": "2026-07-20T18:00:00.000Z",
  "disclaimer": "Prices and availability are captured live from each marketplace at the time of the call and change constantly — `dataAsOf` states exactly when. Always confirm on the marketplace before purchasing. Links may be affiliate links."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brmarket-brazilian-marketplace-product-search-d802815d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from brmarket.thomenz.me](https://www.zero.xyz/host/brmarket.thomenz.me/llms.txt)
