{"uid":"cap_RNlRlUgUMJwzL2AdnXp0U","slug":"brmarket-image-based-brazilian-marketplace-product-search-b37a0678","name":"brmarket Image-Based Brazilian Marketplace Product Search","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).","url":"https://brmarket.thomenz.me/v1/search/image","method":"POST","headers":{},"bodySchema":null,"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_bKoGMS5OWWXOGmdGPXIlv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Find cheapest electronics across Brazilian stores","prompt":"I'm looking at this smart watch right here — can you search Mercado Livre, Shopee, and AliExpress all at once and show me which one has it cheapest in reais, including the affiliate links so I can track my commission?"},{"title":"Compare kitchen appliance prices before buying","prompt":"I took a picture of this blender at a friend's house and really want one — can you check the current prices on Mercado Livre and AliExpress for me in BRL and let me know if any sellers are offering free shipping?"},{"title":"Track product availability across multiple marketplaces","prompt":"Can you look up this sneaker in my photo across all three Brazilian marketplaces and tell me which has it in stock with the best price right now, plus give me the affiliate links if you've got them?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:34:47.297Z","isFirstParty":false}