Whatnot

Live shopping auctions, listings, sellers, and categories from Whatnot, served as plain REST.

Endpoints

Endpoint	Query params	What it returns	Price	Data up to
`GET /whatnot/livestreams`	`category`, `tag`, `limit`, `cursor`	Live livestream listings for a category or tag.	$0.003	15 sec
`GET /whatnot/livestreams/search`	`q`, `status`, `sort`, `limit`, `cursor`	Search livestreams.	$0.003	15 sec
`GET /whatnot/livestreams/detail`	`id`	Full detail for one livestream.	$0.003	10 sec
`GET /whatnot/livestreams/listings`	`id`, `limit`, `cursor`	Listings featured in one livestream.	$0.003	15 sec
`GET /whatnot/listings/search`	`q`, `sort`, `category`, `buying_format`, `min_seller_rating`, `premier_shop`, `seller_country`, `min_price`, `max_price`, `graded`, `autographed`, `condition`, `language`, `product_type`, `set`, `rarity`, `grade`, `grading_service`, `card_number`, `year`, `include_total`, `limit`, `cursor`	Listing search results.	$0.003	1 min
`GET /whatnot/listings/filters`	`q`	Available listing search filters.	$0.003	5 min
`GET /whatnot/listings/detail`	`id`	Full detail for one listing.	$0.003	1 min
`GET /whatnot/sellers/search`	`q`, `limit`, `cursor`	Search sellers.	$0.003	5 min
`GET /whatnot/sellers/profile`	`username`, `include_profile_details`	Seller profile.	$0.003	5 min
`GET /whatnot/sellers/reviews`	`username`, `min_rating`, `include_reviewers`, `limit`, `cursor`	Reviews for one seller.	$0.003	5 min
`GET /whatnot/sellers/listings`	`username`, `q`, `buying_format`, `min_price`, `max_price`, `sort`, `limit`, `cursor`	A seller's active listings.	$0.003	1 min
`GET /whatnot/sellers/livestreams`	`username`, `limit`, `cursor`	A seller's livestreams.	$0.003	1 min
`GET /whatnot/categories`	`parent`	Category listing, optionally a category's children.	$0.001	15 min
`GET /whatnot/tags`	`type`, `limit`, `cursor`	Tag listing by type.	$0.003	15 min
`GET /whatnot/autocomplete`	`q`	Search-box autocomplete.	$0.003	30 sec

Prices are per call, paid in USDC with x402. "Data up to" is the cache window: a repeated call inside it returns the same data.

Calling it

# x402: no account or API key. The server answers 402 with payment instructions; an x402 client pays and repeats the request.
curl -i "https://<base-url>/whatnot/listings/search?q=pokemon+cards"

Responses are JSON. Field names follow the upstream source, so a response can be larger than the table above suggests.

Notes

buying_format, min_seller_rating, sort, status, and type are closed enums.
sellers/profile hides bio/displayName/profileImage/storeImage/image unless include_profile_details is set.
listings/search's include_total caps the reported total at 10000.