Whatnot Scraper

Turn Whatnot into structured marketplace data. Search by keyword or search URL for listings, live shows, and sellers. Look up known sellers for profile stats, buyer reviews, upcoming / live shows, and shop inventory. Browse top-level categories or trending livestream tags with viewer counts. Built for card dealers, resellers, lead gen, and market research — no Whatnot account required.

Features

• Three modes — search, seller, and category in one Actor
• Search — keywords or pasted search URLs; verticals: PRODUCT, LIVESTREAM, USER, CATEGORY, UNIVERSAL
• Seller profiles — followers, sold count, rating, shipping days, verification, bio
• Buyer reviews — overall / shipping scores, text, date, seller reply
• Live & upcoming shows — title, status, viewers, start time
• Shop listings — buy-it-now and auction asking prices from a seller shop
• Categories — top-level category list, or trending tags sorted by viewers
• Optional Cookie header for signed-in sessions (public data works without it)
• Export Dataset as JSON, CSV, Excel, or Google Sheets

Modes

Search

Use searchQueries and / or searchUrls. Text queries use the vertical field; each search URL keeps its own query and searchVertical from the link.

Vertical	Typical rows
PRODUCT	Listings (buy-it-now / auction)
LIVESTREAM	Live and recent shows
USER	Seller / user accounts
CATEGORY	Related tags / categories
UNIVERSAL	Mixed feed

Include toggles (includeListings, includeLivestreams, includeUsers, includeCategories) filter which result types are kept for text queries. Users and categories are off by default so listing / show searches stay clean.

Seller

Pass usernames (or profile URLs) and / or numeric / Relay userIds. Toggle profile, reviews, shows, and shop independently. Optional query filters shop listings by text. showStatus filters shows to live, upcoming, or all.

Category

• list — top-level marketplace categories
• trending — livestream tags with viewerCount / livestreamCount (sortable)

Input

Field	Mode	Default	Description
mode	All	search	search, seller, or category
searchQueries	Search	—	Keywords, each run separately
searchUrls	Search	—	Whatnot search page URLs
vertical	Search	PRODUCT	Result type for text queries
includeListings / includeLivestreams	Search	true	Keep listings / shows
includeUsers / includeCategories	Search	false	Keep users / tags
maxResultsPerQuery	Search	100	Cap per query and per URL
usernames / userIds	Seller	—	Sellers to look up
includeProfile / includeShows / includeReviews	Seller	true / true / true	Sections to fetch
includeShop	Seller	false	Active shop listings
query	Seller	—	Optional shop text filter
maxReviews / maxListings / maxShows	Seller	50 / 50 / 25	Per-seller caps
showStatus	Seller	all	live, upcoming, or all
categoryView	Category	list	list or trending
maxCategories	Category	50	Category / tag cap
sortBy	Category	VIEWER_COUNT	Trending sort
cookies	All	—	Optional Cookie header
proxyConfiguration	All	—	Proxies recommended for production

Example — search listings

{
  "mode": "search",
  "searchQueries": ["pokemon cards"],
  "vertical": "PRODUCT",
  "maxResultsPerQuery": 20,
  "includeListings": true
}

Example — seller with reviews and shop

{
  "mode": "seller",
  "usernames": ["ah_sneakers"],
  "includeProfile": true,
  "includeReviews": true,
  "includeShows": true,
  "includeShop": true,
  "maxReviews": 20,
  "maxListings": 20,
  "maxShows": 10
}

Example — trending categories

{
  "mode": "category",
  "categoryView": "trending",
  "sortBy": "VIEWER_COUNT",
  "maxCategories": 25
}

Output

One Dataset row per entity. Discriminator field: type.

type	Description
listing	Buy-it-now or auction listing (price, currentBid, transactionType, seller, images, url)
user	Search hit for a user / seller
seller	Full seller profile metrics
review	Buyer review with ratings and text
livestream	Live or scheduled show
category	Category or livestream tag
error	Skipped / invalid target

Prices are returned as Whatnot sends them (amount / currency / amountSafe). Treat them as asking prices or bids, not confirmed sale prices. soldCount is a seller total, not revenue.

Listing example

{
  "type": "listing",
  "id": "TGlzdGluZ05vZGU6MjQ1NDY4MzM0OQ==",
  "title": "Pokemon 30th AR Complete set",
  "transactionType": "BUY_IT_NOW",
  "price": { "amount": 7000, "currency": "JPY", "amountSafe": 7000 },
  "user": { "username": "nako_cardclub_japan" },
  "url": "https://www.whatnot.com/listing/2454683349",
  "searchQuery": "pokemon cards",
  "vertical": "PRODUCT",
  "scrapedAt": "2026-10-23T05:50:00.000Z"
}

Tips

• Start with one query or one username and a small limit (maxResultsPerQuery: 10) to validate output shape.
• Residential proxies are recommended for production and higher volume.
• Schedule seller runs daily and diff soldCount / followerCount between runs to track growth.
• This Actor collects public marketplace data only — not private orders, payouts, or completed sale histories.
• Category deep-dive leaderboards (per-tag ranked sellers) are not included in this version; use list / trending plus seller mode for follow-up.

Related use cases

• Price-check a trading card across sellers before buying
• Build a lead list of niche sellers (vertical: USER) then enrich with seller mode
• Monitor competitors' ratings, reviews, and upcoming shows on a schedule