{"uid":"cap_-yxOK4eRcXOBqEYphKz2s","slug":"mercadolivre-product-offers-scraper-488952cb","name":"MercadoLivre Product Offers Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/mercado?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"enum":["relevance","price_asc","price_desc"],"type":"string","default":"relevance","description":"Order the collected offers by page order or price. Price sorting applies to the crawled pages."},"maxItems":{"type":"integer","default":50,"minimum":0,"description":"Maximum number of dataset rows. Set to 0 to collect all matches from the page limit."},"priceMax":{"type":"number","minimum":0,"description":"Keep offers at or below this price in Brazilian reais."},"priceMin":{"type":"number","minimum":0,"description":"Keep offers at or above this price in Brazilian reais."},"startUrls":{"type":"array","description":"Public Brazil offers pages to crawl. Use the general offers page or an offers URL with a category filter. Other page types currently return verification challenges."},"searchQueries":{"type":"array","description":"Optional product title terms. Each phrase is matched against the offers pages being crawled; this is not a full marketplace search."},"maxPagesPerQuery":{"type":"integer","default":3,"maximum":21,"minimum":1,"description":"Number of offers pages to scan per URL, up to the site's observed 21-page limit."},"officialStoresOnly":{"type":"boolean","default":false,"description":"Keep cards visibly marked as official stores."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"id":null,"price":null,"title":null,"itemId":null,"siteId":null,"permalink":null,"canonicalUrl":null,"catalogProductId":null}],"product":"mercado"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HbGdHJV1pIX31hNpr8gRU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Crawls MercadoLivre Brazil offers pages and returns structured product listings with title, price, permalink, and item identifiers.","exampleAgentPrompt":"Scrape MercadoLivre Brazil for up to 50 smartphone listings under R$2000, sorted by price ascending, across 3 pages — give me the title, price, and link for each offer.","exampleUseCases":[{"title":"Price comparison for electronics","prompt":"Search MercadoLivre Brazil for 'notebook gamer' listings, filter to items between R$3000 and R$7000, sort by price ascending, and return the top 30 results with their titles, prices, and product links."},{"title":"Official store product monitoring","prompt":"Pull up to 20 offers from this MercadoLivre category page — https://www.mercadolivre.com.br/ofertas — but only show me cards from official stores, sorted by relevance."},{"title":"Category price research for resellers","prompt":"Crawl MercadoLivre Brazil offers for 'fone de ouvido bluetooth' across 5 pages and give me everything priced at or below R$150, with item IDs and permalink URLs so I can track them later."}],"resultDescription":"A JSON object containing a count of matched items and an array of product records, each with title, price in BRL, item ID, site ID, permalink, canonical URL, and catalog product ID. Fields may be null if not found on the page.","failureModes":["Empty result set if crawled pages return CAPTCHA or verification challenges — not charged","No results if priceMin/priceMax filters exclude all scraped items","Incomplete fields (nulls) if MercadoLivre page structure has changed","Error if startUrls contains non-offers page types (e.g. product detail or search pages)","Rate or page limit exceeded if maxPagesPerQuery exceeds 21"],"whenToPreferThis":"Choose this endpoint when you need structured product data from MercadoLivre Brazil specifically — including price filtering in BRL, official store filtering, and sorting — without building your own scraper. Prefer it over generic web scrapers when you need normalized output fields (item ID, catalog product ID, canonical URL) ready for downstream processing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T03:55:51.903Z","isFirstParty":false,"canonicalSlug":"mercadolivre-product-offers-scraper-488952cb"}