{"x402_version":2,"service":{"name":"BR Marketplace Search","tags":["brazil","ecommerce","product-search","price-comparison","shopping"]},"network":"base","chain":"eip155:8453","networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"billing":{"invalid_input":"422 before the 402 — never charged. GET /v1/search?q= is free entirely","no_marketplace":"503 with settlement cancelled when every marketplace fails. A search that ran and found nothing IS an answer and is charged — `sources` shows who replied","retries":"Send `Idempotency-Key`; a lost paid response replays free for 15 min (`Idempotency-Replayed: true`)"},"pay_to":{"base":"0xA06a2Cf27F2a703d251600309822e6CC2ee72009","solana":"FafQ6dqRvAQK8TboxoaKbR2po5RahSX6HA5ZMQtf4Wd7"},"resources":[{"path":"/v1/search/image","method":"POST","price":"$0.05","description":"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).","input_schema":{"type":"object","description":"Send EITHER this JSON body with `image_url`, OR a multipart/form-data upload with an `image` file part (JPEG/PNG/WebP, max 5MB). Every /v1/search filter also applies here.","properties":{"image_url":{"type":"string","format":"uri","description":"Public https URL of the product photo. JPEG/PNG/WebP, max 5MB.","examples":["https://example.com/photo.jpg"]},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10},"sort":{"enum":["price_asc","price_desc","relevance"],"default":"price_asc"},"min_price":{"type":"number","minimum":0},"max_price":{"type":"number","minimum":0},"marketplace":{"type":"string","description":"Comma-separated subset. Default: all."},"uf":{"type":"string","description":"Buyer's 2-letter Brazilian state, for the ICMS rate. Default: 20%."},"rerank":{"type":"boolean","default":false,"description":"Opt-in LLM relevance pass, same as on /v1/search — and worth it MORE often here: a query distilled from a photo is fuzzy by nature, so accessories and same-word-different-product matches are likelier. Drops offers that are not the pictured product. Costs ~400ms. See `relevance` in the response for what was removed."}},"required":["image_url"]},"output_example":{"interpreted_query":"Apple iPhone 14 Pro 128GB smartphone roxo","query":"Apple iPhone 14 Pro 128GB smartphone roxo","results":[{"marketplace":"mercadolivre","productId":"MLB19615350","title":"Apple iPhone 14 Pro 512 GB Dourado","priceCents":300000,"url":"https://produto.mercadolivre.com.br/MLB-4904112231","affiliateUrl":null,"imageUrl":"https://http2.mlstatic.com/D_NQ_NP_2X_123456-MLB.webp","seller":{"id":"182736450","name":null,"officialStore":false},"shippingFree":true,"dataAsOf":"2026-07-17T13:30:34.360Z"},{"marketplace":"aliexpress","productId":"1005011820157510","title":"Excellent A8 Wireless Bluetooth Earbuds Active Noise Cancellation","priceCents":8919,"originalPriceCents":20270,"url":"https://www.aliexpress.com/item/1005011820157510.html","affiliateUrl":"https://s.click.aliexpress.com/e/_c2ROmufZ","imageUrl":"https://ae-pic-a1.aliexpress-media.com/kf/S9797cb68d7f54af6a1e0544043443f47J.jpg","seller":{"id":"1105334068","name":"Shop1105334068 Store","officialStore":false},"shippingCents":1285,"shipFromCountry":"CN","deliveryDaysMax":19,"origin":"international","rating":4.85,"soldCount":84,"dataAsOf":"2026-07-17T13:30:34.360Z"}],"sources":{"mercadolivre":"ok","shopee":"not_configured","aliexpress":"ok"},"count":2,"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."}},{"path":"/v1/compare","method":"POST","price":"$0.04","description":"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.","input_schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Product URL from any store (Mercado Livre, Shopee, AliExpress, Amazon, Magalu, Kabum, ...). Short links are expanded.","examples":["https://www.mercadolivre.com.br/x/p/MLB42996179"]},"uf":{"type":"string","description":"Buyer's 2-letter Brazilian state, for the ICMS rate in the landed-price estimate. Default: 20%.","examples":["SP"]},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10,"description":"How many cheaper candidates to return. Cap 20."}},"required":["url"]},"output_example":{"compare":true,"source":{"title":"Painel Central Inteligente Maxpanel - Novadigital MPN-10","brand":"Novadigital","model":"MPN-10","priceCents":250268,"marketplace":"magazineluiza","url":"https://www.magazineluiza.com.br/painel-central-inteligente-maxpanel-novadigital/p/ad3g3a21d1/","resolved_via":"gemini"},"query":"novadigital mpn 10 painel central inteligente maxpanel","results":[{"marketplace":"aliexpress","productId":"1005011820157510","title":"Novadigital MaxPanel MPN-10 Zigbee Smart Home Control Panel","priceCents":187848,"originalPriceCents":20270,"url":"https://www.aliexpress.com/item/1005011820157510.html","affiliateUrl":"https://s.click.aliexpress.com/e/_c2ROmufZ","imageUrl":"https://ae-pic-a1.aliexpress-media.com/kf/S9797cb68d7f54af6a1e0544043443f47J.jpg","seller":{"id":"1105334068","name":"Shop1105334068 Store","officialStore":false},"shippingCents":1285,"shipFromCountry":"CN","deliveryDaysMax":19,"origin":"international","rating":4.85,"soldCount":84,"dataAsOf":"2026-07-17T13:30:34.360Z","landed_price_estimate":236889,"import_tax_applied":true,"match_confidence":{"score":0.82,"level":"high"},"cheaper_than_source":true,"savings_cents":13379}],"sources":{"mercadolivre":"ok","shopee":"not_configured","aliexpress":"ok"},"count":1,"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."}}],"free_resources":[{"path":"/v1/search","method":"GET","price":"$0.00","description":"FREE. Search Brazilian marketplaces (Mercado Livre, Shopee, AliExpress) in one call: normalized BRL prices in cents, canonical + affiliate links, AliExpress freight and ships-from origin (ranked on the real total), rating and sold count. Per-marketplace `sources` state ships with every response, so a degraded marketplace is visible, never silent. `rerank=true` drops accessories and homonyms (+~400ms). Identical queries are cached 10 min; a best-effort per-IP limit applies.","input_schema":{"type":"object","properties":{"q":{"type":"string","minLength":2,"description":"What to search for.","examples":["iphone 14 pro"]},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10,"description":"Results in the merged page. Cap 20."},"sort":{"enum":["price_asc","price_desc","relevance"],"default":"price_asc","description":"Default is price_asc — cheapest first."},"min_price":{"type":"number","minimum":0,"description":"Minimum price in BRL (e.g. 199.90)."},"max_price":{"type":"number","minimum":0,"description":"Maximum price in BRL."},"marketplace":{"type":"string","description":"Comma-separated subset to query: mercadolivre, shopee, aliexpress. Default: all.","examples":["mercadolivre,shopee"]},"uf":{"type":"string","description":"Buyer's 2-letter Brazilian state, for the ICMS rate in landed-price estimates. Default: 20% (ceiling).","examples":["SP"]},"rerank":{"type":"boolean","default":false,"description":"Opt-in LLM relevance pass. OFF by default and worth turning ON whenever the query has a cheaper accessory, part or homonym — it drops offers that merely contain the words (a coffee FILTER for 'cafeteira', an AirPods CASE for 'fone bluetooth', a wired 3.5mm earphone for a bluetooth query). Costs ~400ms. A basic price-sanity filter always runs either way; see `relevance` in the response for what each pass removed."}},"required":["q"]},"output_example":{"query":"iphone 14 pro","results":[{"marketplace":"mercadolivre","productId":"MLB19615350","title":"Apple iPhone 14 Pro 512 GB Dourado","priceCents":300000,"url":"https://produto.mercadolivre.com.br/MLB-4904112231","affiliateUrl":null,"imageUrl":"https://http2.mlstatic.com/D_NQ_NP_2X_123456-MLB.webp","seller":{"id":"182736450","name":null,"officialStore":false},"shippingFree":true,"dataAsOf":"2026-07-17T13:30:34.360Z"},{"marketplace":"aliexpress","productId":"1005011820157510","title":"Excellent A8 Wireless Bluetooth Earbuds Active Noise Cancellation","priceCents":8919,"originalPriceCents":20270,"url":"https://www.aliexpress.com/item/1005011820157510.html","affiliateUrl":"https://s.click.aliexpress.com/e/_c2ROmufZ","imageUrl":"https://ae-pic-a1.aliexpress-media.com/kf/S9797cb68d7f54af6a1e0544043443f47J.jpg","seller":{"id":"1105334068","name":"Shop1105334068 Store","officialStore":false},"shippingCents":1285,"shipFromCountry":"CN","deliveryDaysMax":19,"origin":"international","rating":4.85,"soldCount":84,"dataAsOf":"2026-07-17T13:30:34.360Z"}],"sources":{"mercadolivre":"ok","shopee":"not_configured","aliexpress":"ok"},"count":2,"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."},"rate_limit":"~30 distinct queries per 60s per IP (best effort); repeated identical queries are cached 10 min and are not counted"},{"path":"/v1/deals","method":"GET","price":"$0.00","description":"Free trending-deals feed from AliExpress: today's hot / best-seller products, ranked by our affiliate margin, as the same normalized offers as /v1/search (BRL prices in cents, canonical + affiliate links, rating, sold count). Optional keywords (q), category ids, price window and buyer state (uf). AliExpress-only — the one marketplace here with a deals API. Free by decision: the value is the affiliate deal itself, so clicks, not a paywall, are the point."},{"path":"/v1/taxes/import","method":"GET","price":"$0.00","description":"Estimate the Brazilian import tax on a cross-border purchase (landed price). Give the product value (and freight) in BRL cents or in USD, plus an optional buyer state (uf); get back the Import Tax (0% up to US$50, else 30% − US$20), the ICMS por-dentro by state, the total landed price, the USD rate used (Bacen PTAX) and the ruleset version. Free, deterministic. MP 1.357/2026 — may change."}],"note":"In x402 v2 discovery is primarily handled by the Coinbase CDP facilitator (Bazaar) after the first settlement. This manifest is informational."}