Live-commerce and category trend tracking
Use Whatnot endpoints to turn live-commerce and category trend tracking into repeatable API requests with documented inputs and JSON responses.
Turn Whatnot's public live-shopping data into structured JSON — browse live shows by category, the full category list, and a specific live show's current shop feed (items up for sale, pricing), as normalized JSON. Credential-free.
Browse Whatnot live shopping shows by category and get a live show's current shop feed as structured JSON.
Endpoint families
3
Documented params
5
Examples
3
Live catalog snapshot
Active endpoints
3
Methods
GET
Required params
5
Schema refs
3
{
"platform": "Whatnot",
"endpoint": "whatnot-browse",
"method": "GET",
"path": "/whatnot/browse",
"auth": "apiKey"
}Use cases
Browse Whatnot live shopping shows by category and get a live show's current shop feed as structured JSON.
Use Whatnot endpoints to turn live-commerce and category trend tracking into repeatable API requests with documented inputs and JSON responses.
Use Whatnot endpoints to turn live show and seller monitoring into repeatable API requests with documented inputs and JSON responses.
Use Whatnot endpoints to turn auction pricing research into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live Whatnot endpoint catalog — 3 endpoints, 5 documented request parameters, and 3 published response schemas — the same catalog Docs and Playground run against.
3 documented Whatnot endpoints, grouped into 3 request families — Browse, Categories and Live.
5 request parameters are documented across those Whatnot endpoints, 5 of them required — the full input contract is public before you write any integration code.
3 of the 3 Whatnot endpoints ship a recorded example response, and 3 carry a documented response schema — you can code against the real JSON before the first request.
Whatnot endpoints document their error responses (400, 404, 500 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
3 hosted MCP tools back the Whatnot endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
These cards are generated from the active endpoint catalog, so the landing page reflects the same API surface used by Docs and Playground.
/whatnot/browse
/whatnot/categories
/whatnot/live/{id}
Endpoint catalog
/whatnot/browseReturns the live and upcoming shows currently listed under a Whatnot category: seller, title, status, start time, thumbnail, and tags. Public data sourced from Whatnot's own GraphQL API.
Response notes
- `id` is a show's live-stream id — pass it directly as the `id` path parameter to [`/whatnot/live/{id}`](whatnot-live.md) for that show's current shop feed. - `status` reflects Whatnot's own show state (e.g. `PLAYING`); a show that hasn't started yet still appears in the list with a future `start_time_ms` and a non-`PLAYING` status. - An unrecognized `category` returns `404`. - A missing `category` returns `400` before any upstream request is made. Example response: ```json { "code": 200, "msg": "OK", "data": { "category": "trading_card_games", "shows": [ { "id": "6ddb7fd2-43bb-44e0-8ee8-6656e82fa26a", "url": "https://www.whatnot.com/live/6ddb7fd2-43bb-44e0-8ee8-6656e82fa26a", "title": "$100k Late Night Slab Show", "seller_username": "legacy_auction_house", "status": "PLAYING", "start_time_ms": 1785996739803, "thumbnail_url": "https://images.whatnot.com/...", "tags": ["Sudden Death", "Graded Cards", "Pokémon"] } ] } } ```
MCP tool whatnot_browse
/whatnot/live/{id}Returns a Whatnot live show's current shop feed: every product, auction, and giveaway listing currently visible in the show, each with its seller's rating. Public data sourced from Whatnot's own GraphQL API.
Response notes
- `transaction_type` distinguishes how a listing is sold: `AUCTION` (bid-based, `current_bid_cents`/`current_bid_count` populated once bidding starts), `GIVEAWAY`, or `BUY_NOW`. - `status` reflects the listing's own lifecycle (e.g. `created`, `running`, `sold`), not the show's overall live/ended state. - `seller.rating`/`seller.review_count` are scoped to the listing's seller, not the requester — there is no separate seller-profile lookup this endpoint calls. - An unknown or ended show id returns `200` with `"products": []`, not an error — Whatnot's own backend doesn't distinguish "no such show" from "a real show with nothing currently listed." - A missing `id` returns `400` before any upstream request is made. Example response: ```json { "code": 200, "msg": "OK", "data": { "id": "6ddb7fd2-43bb-44e0-8ee8-6656e82fa26a", "url": "https://www.whatnot.com/live/6ddb7fd2-43bb-44e0-8ee8-6656e82fa26a", "products": [ { "id": "TGlzdGluZ05vZGU6MjEzMTA5NzI1NA==", "title": "slab", "description": "show live", "price_cents": 1000, "currency": "USD", "status": "running", "transaction_type": "AUCTION", "quantity": 219, "seller": { "username": "legacy_auction_house", "rating": 4.9, "review_count": 128914 } } ] } } ```
MCP tool whatnot_live
/whatnot/categoriesReturns Whatnot's full top-level category list (e.g. "Trading Card Games", "Sneakers & Streetwear"). Each entry's slug is usable directly with /whatnot/browse's category filter. Public data sourced from Whatnot's own GraphQL API.
Response notes
- Each entry's `slug` is the value to pass as [`/whatnot/browse`](whatnot-browse.md)'s `category` query parameter. - This list changes rarely; results are fetched live on every call, not cached client-side. Example response: ```json { "code": 200, "msg": "OK", "data": { "categories": [ { "id": "Q2F0ZWdvcnlOb2RlOjE0OQ==", "name": "Trading Card Games", "slug": "trading_card_games" }, { "id": "Q2F0ZWdvcnlOb2RlOjM=", "name": "Sports Cards", "slug": "sports_cards" }, { "id": "Q2F0ZWdvcnlOb2RlOjY1Ng==", "name": "Women's Fashion", "slug": "womens_fashion" } ] } } ```
MCP tool whatnot_categories
Related APIs
Marketplaces & Retail
Collect marketplace product signals from Amazon without building brittle storefront scrapers.
Marketplaces & Retail
Build resale, pricing, and marketplace workflows from structured eBay data.
Marketplaces & Retail
Turn public Shop.app product and merchant pages into structured JSON for e-commerce product intelligence, price research, shop monitoring, and marketplace discovery workflows.
How to scrape Whatnot
Crawlora's Whatnot endpoints return category browsing and a live show's shop feed as normalized JSON with one API key — no Whatnot account required.
/whatnot/categories takes no parameters and returns all 37 categories, each with an id, a display name and a slug. You need the slug, not the name — it is underscore-separated, so Sports Cards is sports_cards.
Pass that slug to /whatnot/browse — the display name or a hyphenated variant returns a 404, so sports_cards works while "Sports Cards" and sports-cards both fail. A browse returns around 24 shows, each with id, url, title, seller_username, status, start_time_ms and thumbnail.
status tells you whether a show is live now or scheduled, and start_time_ms is a Unix timestamp in milliseconds — divide by 1,000 before feeding it to a seconds-based date function.
Pass a show id from /whatnot/browse to /whatnot/live/{id} for that show's current shop feed — items up for sale and pricing.
Re-run browse or a specific show on a schedule to track category activity and item pricing over time. Because a show's feed changes while it runs, sampling interval matters more here than on a static catalog.
FAQ
Fetch /whatnot/categories first, then pass a category's slug to /whatnot/browse. The response is a normalized list of current live shows with seller, status, start time and thumbnail — no Whatnot account required.
Almost certainly because you passed the category's display name rather than its slug. The slug is underscore-separated: sports_cards succeeds, while both "Sports Cards" and sports-cards return a 404. Every valid slug is listed in /whatnot/categories, so read them from there rather than deriving them from the names.
Yes — /whatnot/live/{id} returns a live show's current shop feed, including items and pricing, as structured JSON.
No Whatnot login or auth token is required from the caller — only your Crawlora API key.