{"uid":"cap_nM1W3O-4b7xyGcq2D0R5a","slug":"mercado-livre-offers-scraper-x402-83f264db","name":"Mercado Livre Offers Scraper (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/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_UUSqey-Q8sKnza-3LAaQH","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":"Scrapes structured product offer listings from Mercado Livre Brazil pages, returning titles, prices, IDs, and permalinks with pay-per-call USDC billing.","exampleAgentPrompt":"Scrape Mercado Livre Brazil for smartphone listings under R$2000 — sort by price ascending, grab up to 50 items from the first 3 pages, and only include official store offers. Start from the electronics offers page at https://www.mercadolivre.com.br/ofertas.","exampleUseCases":[{"title":"Cheapest phone deals on Mercado Livre","prompt":"Pull the 30 cheapest smartphone offers from Mercado Livre Brazil under R$1500, sorted by price low to high, scanning up to 5 pages — I want title, price, and the product permalink for each one."},{"title":"Official store electronics price research","prompt":"Scrape official store listings only from this Mercado Livre electronics offers page https://www.mercadolivre.com.br/ofertas for products between R$500 and R$3000, sorted by relevance, up to 50 results."},{"title":"Category offer monitoring for price tracker","prompt":"Every day, collect all TV offers from Mercado Livre Brazil on this URL https://www.mercadolivre.com.br/ofertas — up to 100 items across 10 pages sorted by price ascending — so I can track price trends over time."}],"resultDescription":"A JSON object containing a count of matched items and an array of offer records, each with title, price, item ID, site ID, permalink, canonical URL, and catalog product ID. Fields may be null if not present on the page.","failureModes":["Mercado Livre serves a verification challenge page — endpoint returns empty or no charge is incurred","URL points to a non-offers page type — results will be empty","priceMin/priceMax filters too narrow — returns zero items but no charge","maxPagesPerQuery exceeds 21-page site limit — capped at 21","searchQueries terms don't match any visible titles on crawled pages — empty result set","Rate limiting or temporary block by Mercado Livre — empty run, no charge"],"whenToPreferThis":"Choose this endpoint when you need structured product offer data specifically from Mercado Livre Brazil (mercadolivre.com.br) — especially when you want price filtering, official store filtering, or sorted listings without paying for failed or empty runs. Prefer it over generic web scrapers when you need clean, schema-consistent output (title, price, IDs, permalink) from Brazilian marketplace offer pages.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T03:54:45.840Z","isFirstParty":false,"canonicalSlug":"mercado-livre-offers-scraper-x402-83f264db"}