Pricing

Rating

Developer

Actor stats

Categories

Share

Whatnot Search Scraper

Extract Whatnot search results by keyword or URL. Get listings, live streams, products, seller profiles, and categories with prices, bids, and viewer counts.

Use Cases

• Market research — Monitor what's selling and at what price across categories on Whatnot
• Competitor analysis — Track seller listings, pricing strategies, and product catalog
• Price monitoring — Watch listing prices and auction bids over time
• Inventory tracking — Keep an eye on product availability and new listings
• Lead generation — Discover active sellers and their contact profiles
• Content research — Find trending products and livestream topics

Features

• Search Whatnot by keyword — Run one or multiple text queries across any vertical
• Search Whatnot by URL — Paste exact Whatnot search URLs with sort, filter, and vertical params
• Extract product listings — Get titles, descriptions, prices, images, quantities, and transaction types
• Extract live streams — Get active viewer counts, titles, statuses, and stream tokens
• Extract seller profiles — Get usernames, follower counts, sold counts, and seller ratings
• Extract product catalog data — Get product names, listing prices, last sale prices, and listing counts
• Extract categories and tags — Get category labels, viewer counts, and deeplinks
• Search across all verticals — UNIVERSAL mode returns a mixed result set of all types
• Run multiple queries in one go — Each query gets its own result set, results are merged
• Combine URLs and queries — Both sources run together, results interleaved
• Quick results with pagination — Configurable result limits and per-query caps

How It Works

Search by Text Query

Provide one or more search terms. Each query runs against the vertical you choose — or UNIVERSAL to search everything at once.

Supported verticals:

• PRODUCT — Individual item listings (buy-it-now and auction)
• LIVESTREAM — Active live streams with viewer counts
• USER — Seller profiles with ratings and stats
• CATEGORY — Product categories and tags
• UNIVERSAL — All of the above, results interleaved

Search by URL

Paste a Whatnot search URL directly. The scraper parses the URL's own query, vertical, sort, and referring source params — exactly as Whatnot uses them.

Example URLs:

https://www.whatnot.com/search?query=pokemon&searchVertical=PRODUCT
https://www.whatnot.com/search?query=sneakers&sort={"direction":"DESC","field":"VIEWER_COUNT"}
https://www.whatnot.com/search?query=magic+the+gathering&searchVertical=LIVESTREAM

Each URL is independent — the vertical and type selection come from the URL itself, not global settings.

Combined Search

Run URLs and text queries together. Both execute in parallel and results are interleaved into a single output.

Input

At least one of searchUrls or searchQueries is required.

Example Input

{
"searchQueries":["pokemon cards","sneakers"],
"vertical":"PRODUCT",
"maxResultsPerQuery":100
}

Output

Each result is a structured object. The type field tells you what kind of result it is.

Result Types

Listing — A buy-it-now or auction item

{
"type":"listing",
"title":"Pokemon - Cards Dunsparce GG23/GG70 Crown Zenith",
"subtitle":"Mint ∙ Crown Zenith",
"description":"Pokemon - Cards Dunsparce GG23/GG70 Crown Zenith",
"transactionType":"BUY_IT_NOW",
"quantity":1,
"price":{"amount":500,"currency":"GBP"},
"currentBid":null,
"currentBidCount":null,
"isLive":false,
"images":[{"url":"https://images.whatnot.com/..."}],
"user":{
"username":"mysteryraiders",
"sellerRating":{"overall":5,"numReviews":145}
},
"searchQuery":"pokemon cards",
"vertical":"PRODUCT",
"scrapedAt":"2026-05-17T18:31:44.674Z"
}

Livestream — An active live stream

{
"type":"livestream",
"title":"FREE EVOLVING SKIES GIVEAWAY",
"status":"PLAYING",
"startTime":1779027948159,
"activeViewers":260,
"thumbnail":{
"smallImage":"https://images.whatnot.com/...",
"biggerImage":"https://images.whatnot.com/..."
},
"user":{"username":"qualitypulls"},
"tags":[
{"label":"Pokémon","name":"pokemon"},
{"label":"$1 Starts","name":"one_dollar_starts"}
],
"searchQuery":"pokemon cards",
"vertical":"LIVESTREAM",
"scrapedAt":"2026-05-17T18:31:54.957Z"
}

Product — A product catalog entry with aggregated pricing

{
"type":"product",
"name":"Pokemon Booster Pack",
"image":{"url":"https://images.whatnot.com/..."},
"listingPrice":{"amount":499,"currency":"USD"},
"lastSalePrice":{"amount":450,"currency":"USD"},
"numListings":12,
"searchQuery":"pokemon cards",
"vertical":"PRODUCT",
"scrapedAt":"2026-05-17T18:31:55.000Z"
}

User — A seller profile

{
"type":"user",
"username":"pokemoncards",
"isFollowing":false,
"followerCount":186,
"soldCount":null,
"isLive":false,
"sellerRating":null,
"profileImage":{"url":"https://images.whatnot.com/..."},
"searchQuery":"pokemon cards",
"vertical":"USER",
"scrapedAt":"2026-05-17T18:31:54.914Z"
}

Category / Tag — A product category or livestream tag with viewer count

{
"type":"tag",
"label":"Pokémon Cards",
"name":"pokemon_cards",
"viewerCount":17726,
"deeplink":"tag/pokemon_cards",
"searchQuery":"pokemon cards",
"vertical":"CATEGORY",
"scrapedAt":"2026-05-17T18:31:54.894Z"
}

Search Metadata

The output array includes a searchMeta object attached to the array itself:

{
"mode":"search",
"sources":["url","query"],
"totalResults":47,
"resultCounts":{
"listing":20,
"livestream":15,
"user":8,
"tag":4
},
"fetchedAt":"2026-05-17T18:31:55.000Z"
}

• mode — Whether results came from URLs, queries, or both
• sources — Which sources were used (url, query)
• totalResults — Total count
• resultCounts — Breakdown by result type
• fetchedAt — ISO timestamp

Results from URL-based searches also include:

• sourceUrl — The original Whatnot search URL
• rawUrlParams — All parsed URL parameters

Common Fields

Every result includes these fields regardless of type:

• type — One of: listing, livestream, product, user, category, tag
• searchQuery — The search term or URL query that produced this result
• vertical — The search vertical (PRODUCT, LIVESTREAM, USER, CATEGORY)
• scrapedAt — ISO 8601 scrape timestamp
• cursor — Pagination cursor (internal use)

FAQ

Can I search multiple queries at once?

Yes. Pass an array of search terms in searchQueries. Each query runs in sequence, results are merged. Each query fetches up to maxResultsPerQuery results.

Can I combine URLs and text queries?

Yes. Both searchUrls and searchQueries run together in parallel. Results are interleaved into a single output.

What data can I extract from listings?

Each listing includes: title, subtitle, description, price, currency, current bid, bid count, quantity, transaction type (buy-it-now or auction), live status, images, seller info with ratings, and scraped timestamp.

Does this need a Whatnot account or login?

No. Public search results are accessible without authentication. Cookies are optional and only needed for personalized results.

What is UNIVERSAL vertical?

UNIVERSAL searches across all content types (PRODUCT, LIVESTREAM, USER, CATEGORY) and interleaves the results so you get a mixed feed — similar to Whatnot's own default search experience.

How are results from different queries combined?

Results are collected per query up to the configured limits, then merged. When both URLs and queries are used, results are interleaved (alternating between sources).

Can I control how many results per query?

Yes. Set maxResultsPerQuery to the number of results you want per query or URL. Each query independently fetches up to that many results.

What if I only want live streams?

Set vertical to LIVESTREAM or use a URL with searchVertical=LIVESTREAM. This returns only active livestream results.

What if I only want sellers?

Set vertical to USER. This returns seller profiles with usernames, ratings, follower counts, and sold counts.

Limitations

• Public data only. Authenticated-only features (following, watchlists) are not available.
• Result counts depend on Whatnot's search index. Extremely niche queries may return fewer results than requested.
• Livestream results are snapshots — viewer counts change in real time on Whatnot.

Support

For issues, feature requests, or questions, open a discussion or issue on the repository.