Live-commerce and category trend tracking
Mit Whatnot-Endpunkten verwandelst du live-commerce and category trend tracking in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
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.
Endpunkt-Familien
3
Dokumentierte Parameter
5
Beispiele
3
Live-Katalog-Snapshot
Aktive Endpunkte
3
Methoden
GET
Pflichtparameter
5
Schema-Referenzen
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.
Mit Whatnot-Endpunkten verwandelst du live-commerce and category trend tracking in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Mit Whatnot-Endpunkten verwandelst du live show and seller monitoring in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Mit Whatnot-Endpunkten verwandelst du auction pricing research in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Managed Execution
Jede Zahl unten stammt direkt aus dem Live-Whatnot-Endpunktkatalog — 3 Endpunkte, 5 dokumentierte Request-Parameter und 3 veröffentlichte Response-Schemas — demselben Katalog, gegen den auch Docs und Playground laufen.
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.
Abdeckungskarte
Diese Karten werden aus dem aktiven Endpunktkatalog generiert, damit die Landingpage dieselbe API-Oberfläche widerspiegelt, die auch Docs und Playground nutzen.
/whatnot/browse
/whatnot/categories
/whatnot/live/{id}
Endpunktkatalog
/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.
Hinweise zur Response
- `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: `PLAYING` (currently live) or `CREATED` (scheduled, not yet started — a show that hasn't started yet still appears in the list with a future `start_time_ms` and a `CREATED` status). An ended-show state almost certainly also exists but was not observed in live testing — ended shows drop out of Whatnot's own Browse/ category feeds essentially immediately. - 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.
Hinweise zur Response
- `transaction_type` distinguishes how a listing is sold: `AUCTION` (bid-based, `current_bid_cents`/`current_bid_count` populated once bidding starts), `GIVEAWAY`, or `BUY_IT_NOW`. - `status` reflects the listing's own lifecycle, not the show's overall live/ended state: `active`, `created`, or `running`. A terminal "sold"/"sold out"-style value almost certainly also exists but was not observed in live testing. - `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.
Hinweise zur Response
- 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
Verwandte 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.
So scrapst du 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.