# brmarket.thomenz.me Brazilian Marketplace Search

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

Searches and compares products across Brazilian marketplaces (Mercado Livre, Shopee, AliExpress) returning normalized BRL prices, affiliate links, shipping flags, ratings, and per-marketplace source status in one call.

## Facts

- Endpoint: GET https://brmarket.thomenz.me/v1/search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brmarket-thomenz-me-brazilian-marketplace-search-e342bc46
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-3wmnTeyxrDmd44qSEhcQ

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-thomenz-me-brazilian-marketplace-search-e342bc46
```

Example prompt: Search for 'tênis Nike Air Max' across all Brazilian marketplaces — Mercado Livre, Shopee, and AliExpress — for a buyer in São Paulo (SP), show me up to 10 results sorted cheapest first, and only include items under R$500.

## When to prefer this

Use this endpoint when you need a single API call to compare product prices across multiple major Brazilian e-commerce platforms (Mercado Livre, Shopee, AliExpress) with normalized BRL pricing, affiliate-ready links, and transparent marketplace health status. Prefer over scraping individual sites or calling each marketplace API separately.

## Known failure modes

- One or more marketplaces degraded or unconfigured — visible via per-source status field, not silent failure
- Query string too short (< 2 chars) — validation error
- limit exceeds 20 — validation error
- Invalid marketplace name in comma-separated list — likely ignored or error
- Payment not received (x402) — 402 Payment Required response
- No results found for query — empty results array
- Invalid UF code — falls back to default 20% ICMS ceiling

## How this service works

Search and compare products across Brazilian marketplaces (Mercado Livre, Shopee, AliExpress) in one call: normalized BRL prices in integer cents, canonical + affiliate links, and honest per-marketplace state on every response.

## Output

A merged list of up to 20 product results with normalized BRL prices in cents, canonical and affiliate URLs, free-shipping boolean, seller rating, sold count, and a per-marketplace 'sources' object showing each marketplace's query status and a 'data_as_of' timestamp so stale or unavailable marketplaces are transparent.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 2,
  "query": "iphone 14 pro",
  "results": [
   {
    "url": "https://produto.mercadolivre.com.br/MLB-4904112231",
    "title": "Apple iPhone 14 Pro 512 GB Dourado",
    "seller": {
     "id": "182736450",
     "name": null,
     "officialStore": false
    },
    "dataAsOf": "2026-07-17T13:30:34.360Z",
    "imageUrl": "https://http2.mlstatic.com/D_NQ_NP_2X_123456-MLB.webp",
    "productId": "MLB19615350",
    "priceCents": 300000,
    "marketplace": "mercadolivre",
    "affiliateUrl": null,
    "shippingFree": true
   },
   {
    "url": "https://www.aliexpress.com/item/1005011820157510.html",
    "title": "Excellent A8 Wireless Bluetooth Earbuds Active Noise Cancellation",
    "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": 8919,
    "marketplace": "aliexpress",
    "affiliateUrl": "https://s.click.aliexpress.com/e/_c2ROmufZ",
    "shippingCents": 1285,
    "deliveryDaysMax": 19,
    "shipFromCountry": "CN",
    "originalPriceCents": 20270
   }
  ],
  "sources": {
   "shopee": "not_configured",
   "aliexpress": "ok",
   "mercadolivre": "ok"
  },
  "data_as_of": "2026-07-17T13:30:34.360Z",
  "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-thomenz-me-brazilian-marketplace-search-e342bc46/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)