{"uid":"cap_kzP5r-URRDa_hWqtyVKO3","slug":"mercari-marketplace-scraper-x402-e013b6ec","name":"Mercari Marketplace 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/mercari?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"enum":["relevance","newest","price_low","price_high","recently_sold"],"type":"string","default":"relevance","description":"Result order requested from Mercari for category and brand pages."},"limit":{"type":"integer","default":100,"minimum":1,"description":"Maximum number of unique listings in the entire run."},"status":{"type":"array","items":{"enum":["on_sale","sold_out","trading"],"type":"string","enumTitles":["On sale","Sold out","Trading"]},"default":[],"description":"Include only these listing states. Empty includes all states."},"keyword":{"type":"string","description":"Search phrase. If URLs are provided, this overrides their keyword. Without URLs, searches the top-level US categories."},"priceMax":{"type":"number","minimum":0,"description":"Maximum listed price in US dollars, inclusive."},"priceMin":{"type":"number","minimum":0,"description":"Minimum listed price in US dollars, inclusive."},"startUrls":{"type":"array","description":"US Mercari category, brand, shop, search, or item URLs. Search URLs are expanded across top-level categories."},"includeDetails":{"type":"boolean","default":false,"description":"Open each item page for description, full photo set, condition, shipping details, and timestamps. Increases requests and cost."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"id":null,"url":null,"type":null,"price":null,"title":null,"listingId":null,"priceCents":null,"description":null}],"product":"mercari"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_R0Oaf_nmaLxtDJ-tYyLM1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes structured product listings from Mercari US, returning titles, prices, IDs, and optionally full item details, charged per successful call via x402 micropayments.","exampleAgentPrompt":"Search Mercari for 'vintage Levi's denim jacket' under $80, return the 50 newest on-sale listings sorted by newest, and include full item details like description and condition.","exampleUseCases":[{"title":"Reseller price research for used goods","prompt":"Search Mercari for 'Air Jordan 1 Retro High OG' and give me the 100 most relevant listings with their prices — I want to see both on-sale and sold-out items so I can figure out what they're actually going for."},{"title":"Brand page inventory snapshot","prompt":"Pull all on-sale listings from this Mercari brand page https://www.mercari.com/brand/123456/ sorted by lowest price first, up to 200 listings, and include full item descriptions and condition details."},{"title":"Keyword deal hunting with price filter","prompt":"Find me Mercari listings for 'Sony WH-1000XM4 headphones' priced between $50 and $150, sorted by newest, and only show items that are currently on sale."}],"resultDescription":"Returns a JSON object with a count of listings and an array of items, each containing listing ID, URL, title, price in dollars, price in cents, listing type, and optionally full description — all scoped to the Mercari US marketplace.","failureModes":["Empty result set (no charge) if keyword or URL yields no matching listings","Mercari rate-limiting or anti-bot measures causing incomplete results","Invalid or non-US Mercari URLs returning errors","Price filter too narrow returning zero results","Unsupported URL types (non-US Mercari domains) failing silently"],"whenToPreferThis":"Use this endpoint when you need structured product listing data from Mercari US specifically — including price research, inventory snapshots, or keyword searches across categories. It is pay-per-successful-call with no charge on empty runs, making it cost-efficient for exploratory searches. Prefer this over generic web scrapers when you need Mercari-native fields like listing status, sort modes, and optional deep item details.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T04:43:41.248Z","isFirstParty":false,"canonicalSlug":"mercari-marketplace-scraper-x402-e013b6ec"}