# brmarket Image-Based Brazilian Marketplace Product Search

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

Search and compare products across Brazilian marketplaces (Mercado Livre, Shopee, AliExpress) using an image as input, returning normalized BRL prices in integer cents, product details, and affiliate links.

## Facts

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

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-image-based-brazilian-marketplace-product-search-b37a0678 -d '<json body>'
```

Example prompt: I have a photo of this iPhone 14 Pro — can you search across Mercado Livre, Shopee, and AliExpress in Brazil to find the best price in BRL, including any free shipping options and affiliate links?

## When to prefer this

Use this endpoint when you need to identify a product from an image and simultaneously retrieve live pricing and purchase links across multiple Brazilian marketplaces (Mercado Livre, Shopee, AliExpress) in a single call, with prices normalized to BRL integer cents and affiliate links included. Prefer this over text-based search when the user has a product image rather than a written query, or when visual identification is more reliable than a keyword description.

## Known failure modes

- Image not recognized or too ambiguous — returns empty results array with count 0
- Shopee not configured — sources.shopee returns 'not_configured'
- Marketplace API timeout — affected marketplace shows error status in sources object
- Invalid or unreachable image URL — 400 or 422 error
- Payment not completed via x402 protocol — 402 Payment Required response
- No products found matching the image — empty results with valid source statuses

## How this service works

Search Brazilian marketplaces from a PRODUCT PHOTO. Send an image (multipart upload or URL); a vision model reads the brand, model and attributes off it, and the resulting query runs across Mercado Livre, Shopee and AliExpress. Returns the same normalized offers as /v1/search, plus `interpreted_query` — the exact text that was searched, so a misread photo is visible. Pass `rerank=true` to drop accessories and same-word-different-product offers (+~400ms).

## Output

A JSON object containing a count of results, an interpreted query string, a list of matched products (each with title, price in BRL cents, marketplace name, product URL, affiliate URL, seller info, image URL, free shipping flag, and a data timestamp), plus a per-marketplace status object showing which sources responded successfully, and a disclaimer about price volatility.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 2,
  "query": "Apple iPhone 14 Pro 128GB smartphone roxo",
  "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.",
  "interpreted_query": "Apple iPhone 14 Pro 128GB smartphone roxo"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brmarket-image-based-brazilian-marketplace-product-search-b37a0678/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)