{"uid":"cap_iZ_eKD274HjFukjfupwIr","slug":"mercari-listing-scraper-ed081b0a","name":"Mercari Listing Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/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_cbWG2BLn4yIjJZel9wv7q","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 and returns structured product listing data from Mercari US, including prices, titles, statuses, and optional item details.","exampleAgentPrompt":"Search Mercari for 'Nintendo Switch OLED' listings that are currently on sale, priced between $200 and $350, sorted by lowest price first, and return up to 50 results with full item details including descriptions and photos.","exampleUseCases":[{"title":"Resale price research for a product","prompt":"Pull up to 100 Mercari listings for 'Air Jordan 1 Retro High OG' that are currently on sale, sorted by price low to high, so I can see what they're going for on the resale market right now."},{"title":"Monitoring sold listings for valuation","prompt":"Scrape Mercari for sold listings of 'Sony WH-1000XM5 headphones' — I want to see what they've actually sold for recently, up to 75 results sorted by newest, so I can figure out a fair resale value."},{"title":"Browsing a Mercari brand or category page","prompt":"Extract all on-sale listings from this Mercari brand page — https://www.mercari.com/brand/68/ — sorted by newest, up to 100 items, and include the full details like condition and shipping info for each one."}],"resultDescription":"Returns a JSON object with a count of listings found, the product source identifier ('mercari'), and an array of items each containing listing ID, URL, type, title, price in dollars, price in cents, and optionally full description when includeDetails is enabled.","failureModes":["Empty result set if keyword or URL yields no matching listings (not charged)","Invalid or non-US Mercari URL causes failed run (not charged)","Rate limiting or anti-scrape measures on Mercari's side may cause partial results","priceMin greater than priceMax returns no results","Unsupported URL type (e.g. non-US Mercari domain) may fail silently"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable Mercari listing data at scale — especially for price research, resale valuation, inventory monitoring, or competitive analysis on the US Mercari marketplace. It is pay-per-successful-call, making it cost-safe for exploratory queries. Prefer it over generic web scrapers when you need Mercari-specific filtering by price, status, and sort order with a clean JSON schema.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:24.596Z","isFirstParty":false,"canonicalSlug":"mercari-listing-scraper-ed081b0a"}