{"uid":"cap_CEvckSMycxLh5Yof7UCR0","slug":"whatnot-scraper-api-x402-42e43182","name":"Whatnot Scraper API (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/whatnot?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"mode":{"enum":["search","seller","category"],"type":"string","default":"search","description":"Choose search results, seller data, or category activity."},"maxItems":{"type":"integer","default":100,"minimum":0,"description":"Hard cap across all records in this run; 0 means no total cap."},"maxShows":{"type":"integer","default":15,"maximum":24,"minimum":1,"description":"Maximum shows per seller or selected category, up to the first rendered batch."},"vertical":{"enum":["PRODUCT","LIVESTREAM","USER","CATEGORY","UNIVERSAL"],"type":"string","default":"PRODUCT","description":"Content type for search terms. Search URLs use their own vertical."},"usernames":{"type":"array","items":{"type":"string"},"description":"Public seller usernames for seller mode, without needing a login."},"maxReviews":{"type":"integer","default":24,"maximum":24,"minimum":1,"description":"Maximum buyer reviews per seller, up to the first 24 public reviews."},"searchUrls":{"type":"array","items":{"type":"string"},"description":"Optional Whatnot search URLs; each URL uses its own query and vertical."},"includeShop":{"type":"boolean","default":false,"description":"Return the first available listings in each seller shop."},"maxListings":{"type":"integer","default":20,"maximum":20,"minimum":1,"description":"Maximum shop listings per seller, up to the first 20 public listings."},"categoryView":{"enum":["list","trending","deep-dive"],"type":"string","default":"list","description":"List categories, sort the first page by viewer count, or inspect selected category feeds."},"includeShows":{"type":"boolean","default":true,"description":"Return public live and scheduled show records for each seller."},"includeTypes":{"type":"array","items":{"type":"string"},"default":[],"description":"Optional result type filter. Empty includes every returned type."},"categorySlugs":{"type":"array","items":{"type":"string"},"description":"Category path slugs for deep-dive view, such as entertainment_cards."},"maxCategories":{"type":"integer","default":24,"maximum":24,"minimum":1,"description":"Maximum categories in list or trending view, up to the first 24."},"searchQueries":{"type":"array","items":{"type":"string"},"description":"Terms to search on Whatnot; each term returns up to the first 24 public results."},"includeProfile":{"type":"boolean","default":true,"description":"Return one seller profile record with public metrics."},"includeReviews":{"type":"boolean","default":true,"description":"Return the first public buyer reviews for each seller."},"maxResultsPerQuery":{"type":"integer","default":24,"maximum":24,"minimum":1,"description":"Maximum records per search term or URL; public pages currently expose at most 24."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"id":null,"url":null,"type":null,"title":null,"vertical":null,"scrapedAt":null,"sourceUrl":null,"searchQuery":null}],"product":"whatnot"}},"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__XCEQEB_1cZ-hA6dHfQxO","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 data from Whatnot (live shopping platform) including search results, seller profiles, and category feeds — charged per successful call via x402 micropayment.","exampleAgentPrompt":"Search Whatnot for 'vintage Pokémon cards' using the PRODUCT vertical, return up to 50 results, and also pull seller data for usernames 'cardking' and 'pokevault' including their live shows and first 24 reviews each.","exampleUseCases":[{"title":"Competitor seller research","prompt":"Pull the public seller profile, upcoming shows, and buyer reviews for Whatnot sellers 'sneakerhaus' and 'jordanvault' — include their shop listings and up to 24 reviews each so I can see what they're selling and how they're rated."},{"title":"Keyword product search","prompt":"Search Whatnot for 'graded baseball cards' in the PRODUCT vertical and give me up to 100 results, including titles, URLs, and which vertical each result came from."},{"title":"Trending category monitoring","prompt":"Show me the trending Whatnot categories sorted by viewer count right now — I want to see what live shopping verticals are hottest at the moment."}],"resultDescription":"A JSON object with a count field and an items array; each item includes id, url, type, title, vertical, scrapedAt, sourceUrl, and searchQuery. The product field confirms 'whatnot'. Items cover products, sellers, shows, reviews, or categories depending on the mode used. Failed or empty runs return no charge.","failureModes":["Empty result set (0 items) — not charged, may indicate bad username or no matching content","Invalid mode enum value — request rejected","maxShows exceeds 24 or maxListings exceeds 20 — clamped or rejected","Search URL not a valid Whatnot URL — no results returned","Payment failure via x402 — request blocked before execution","Whatnot anti-scraping measures triggered — partial or empty response","Unknown category slug — empty category feed returned"],"whenToPreferThis":"Use this endpoint when you need structured, pay-per-use Whatnot data without managing your own scraping infrastructure. It is purpose-built for Whatnot (vs generic scrapers) and covers the platform's core content types: search, sellers, and categories. Prefer it over generic web scraping APIs when you specifically need Whatnot seller profiles, live show schedules, shop inventory, or search result pages — especially when you want to avoid paying for failed runs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:49.605Z","isFirstParty":false,"canonicalSlug":"whatnot-scraper-api-x402-42e43182"}