Whatnot Scraper

Search Whatnot the way its own search box works and get the results as rows. You pick one of three things:

• Listings: the item, its price and currency, Buy It Now or auction, status, quantity, the current bid, the category, and the seller with their rating.
• Live shows: the title, the seller, categories and tags, when it starts, whether it's live now or coming up, and how many people are watching.
• Sellers: username, followers, items sold, rating and number of reviews, whether they're live right now, and how many days they usually take to ship.

No Whatnot account and no API key. It reads the same search a visitor who isn't logged in gets.

Worth knowing before you run it

Whatnot only lets a search go so deep. It will tell you a search has 10,000 listings, then stop handing them over after roughly the first thousand. When that happens the status message says so. More specific words, or a category, get you further.

Prices stay in the seller's currency. Whatnot has sellers in the US, the UK, Canada, Australia, much of Europe and Japan, and a card priced in yen stays in yen. One search can mix six currencies. If you need one, pick a single country under Ships from.

Viewer counts move while you read them. Whatnot orders shows by viewers at the moment it builds the list, and the counts keep changing, so a "most viewers" run comes back roughly in order. In one check of 100 live shows, 38 steps went up instead of down, most of them by fewer than ten viewers.

It's a snapshot. You get the listings for sale when the run happens, and shows that are live or scheduled. Finished shows and past sale prices aren't in it.

Input

What to get. Listings, Live shows or Sellers.

Search words. One search per line, as you'd type it on Whatnot: pokemon, jordan 1, funko pop.

Seller usernames. With or without the @, or a link to the profile. What they do depends on what you're getting:

What to get	With seller usernames
Listings	what's in each seller's shop, searched with your words if you gave any
Live shows	each seller's live and upcoming shows (search words aren't used here)
Sellers	each seller's profile; search words find more sellers on top

Results per search caps what one search word or one seller brings back (100 unless you change it). Results in total caps the whole run (1,000 unless you change it, 10,000 at most).

{
  "searchFor": "listings",
  "keywords": ["charizard"],
  "buyingFormat": "buyItNow",
  "shipsFrom": ["US"],
  "minPrice": 20,
  "maxPrice": 150,
  "sortBy": "priceLowToHigh",
  "maxResultsPerSearch": 200
}

Filters

The same choices Whatnot's filter panel offers.

Filter	Listings	Live shows
Category	yes	yes
Minimum seller rating (4.0, 4.5, 5 stars)	yes	yes
Premier shops only	yes	yes
Ships from	yes	yes
Buying format: Buy It Now or auction	yes
Minimum and maximum price	yes
Condition	yes
Graded only, Autographed only	yes
More item details: Language, Set, Rarity, Grade, Grading Service and so on	yes
Show status: live now or upcoming		yes
Show format: auction, breaks, Buy It Now, graded, singles, surprise sets		yes
Brands, Tags		yes
Sort	price, newly listed	viewers

Categories, brands and tags go by name, the way Whatnot shows them, such as Pokémon Cards. Each search looks the name up in Whatnot's own panel for that search, so a category also brings in everything under it. If Whatnot doesn't offer your category for a search, that search returns nothing and the status says which one. You won't get other categories instead.

Condition and the item details are labels sellers type themselves, so "Near Mint" and "near mint" both exist. The actor sends every spelling of what you wrote.

A price range is in each listing's own currency, and Whatnot compares it in hundredths. That's right for dollars, pounds and euros. Yen have no hundredths, so for yen listings set Ships from to Japan alone and give the range in yen. In any other price-range search, yen listings are left out rather than returned at a price you didn't ask for.

Output

One row per listing, show or seller. The dataset has a view for each.

Listings

Field	Example	Notes
title	Pokemon CGC 8.5 Dark Steelix #10 Reverse Foil
price, currency	399, CAD	the seller's currency
format	buyItNow	or auction
status	ACTIVE	as Whatnot gives it
quantity, currentBid, bidCount	1, null, null	bids only on auctions
category	Pokémon Cards
sellerUsername, sellerRating, sellerReviews	johtojoe, 5, 10
url	https://www.whatnot.com/listing/TGlzdGluZ05vZGU6MjI0NDQzNjk2NQ%3D%3D	the listing page

Also listingId, subtitle, description, inLiveShow, labels, sellerPremierShop, imageUrl, sellerUrl, searchedFor and scrapedAt.

Live shows

Field	Example	Notes
title	Rapid Fire Sudden Death Pokemon Slabs
sellerUsername, sellerRating	pokemonwizard, 5
status	upcoming	or live
startTime	2026-09-14T19:30:00.000Z	UTC
viewers	0	people watching when the run read it
categories, tags	["Pokémon Cards"], ["Pokémon"]
url	https://www.whatnot.com/live/2f77a938-46fc-4de9-9c2d-93f739433e14

Also showId, sellerReviews, sellerPremierShop, thumbnailUrl, sellerUrl, searchedFor and scrapedAt.

Sellers

Field	Example	Notes
username, displayName	pokemonwizard, Wiz
followers, following	290403, 753
soldCount	362724	empty for accounts that haven't sold
rating, reviews	5, 65709
isLive, verifiedSeller, premierShop	false, false, true
averageShipDays	1
url	https://www.whatnot.com/user/pokemonwizard

Also bio, profileImageUrl, userId, searchedFor and scrapedAt.

The run also leaves RUN_REPORT in its key-value store: each search with what Whatnot listed and what came back, filters Whatnot didn't offer, rows skipped and why, and why the run stopped.

What you pay

Each row in your dataset is one charge, whether it's a listing, a show or a seller. Nothing else costs anything: not a search that finds nothing, not a search Whatnot didn't answer, not a row that didn't match your filters, and not a repeat of something you already got in the same run. If you set a maximum charge for the run, it stops when that's reached, and every row you get has been paid for. The price is on the Pricing tab.

Limits

• 20 search words, 100 seller usernames and 500 searches per run. Usernames times words counts as searches when you give both for listings.
• 10,000 rows per run.
• Expect a minute or two before the first rows arrive. Whatnot usually makes a new run wait before it answers, and the actor waits and asks again rather than giving up, for up to about five minutes at a time. You aren't charged for the wait.
• Once it's going, it reads one page of up to 50 at a time, about one page a second, so 1,000 listings take around half a minute more.
• Searches Whatnot still won't answer are named in the status, and nothing is charged for them.

Where the data comes from

Whatnot's public search, the one its website uses for visitors who aren't logged in. Whatnot has nothing to do with this actor. Its terms of service restrict automated use of the app, so check them against what you plan to do with the data.

Questions

Can I watch a seller's shop every day? Put the username under Seller usernames, choose Listings, and schedule the actor. Each run returns what's in the shop that day.

Why did I get fewer rows than Whatnot's count? Either Whatnot stopped handing results over (the status says so), or rows didn't match your filters and were skipped (the status says how many), or you hit Results per search.

Why is a price in CAD or JPY? Each listing keeps the seller's own currency. Use Ships from to keep to one country.

Does it log in or see anything private? No. It sees what a visitor who isn't logged in sees.