+Whatnot API
Live and upcoming Whatnot shows, viewer counts, categories and seller shop profiles as JSON, without a seller account.
The API.SH Whatnot API reads Whatnot's public browse, category and seller pages. The categories route lists the browse page busiest first, with how many people are watching each one now. For a category such as pokemon_cards or sneakers, the live route returns the first page of live and upcoming shows with title, status, start time, viewers, watchlist count, tags, thumbnail and the seller, plus the page's highlighted sections and filter facets with counts; filter to live or upcoming and sort by viewers or start time. A seller's profile gives rating, review count, items sold, followers, average ship days, verified and business flags, premier shop, badges and their live, upcoming and recent shows.
- 3 endpoints
- from $1 / 1,000 calls
- 1,000 free credits / month
- failed calls free
GET https://api.api.sh/whatnot/v1/ live
{"category": "pokemon_cards","title": "Pokémon Cards","url": "https://www.whatnot.com/category/pokemon_cards","count": 24,"has_more": true,"shows": [{"id": "37b38883-21c1-41b9-8710-f3a3545ee9da","url": "https://www.whatnot.com/live/37b38883-21c1-41b9-8710-f3a3545ee9da","title": "🇺🇸 ⚡️🐻GINORMOUS VINTAGE NIGHT🏎️⚡️","status": "PLAYING","start_time": "2026-11-03T23:00:28.806Z","viewers": 1309,"watchlist_users": 107,"categories": [{"label": "Pokémon Cards","slug": "pokemon_cards"}],"tags": ["Vintage","Graded Cards"],"labels": [],"thumbnail": "https://images.whatnot.com/eyJidWNrZXQiOiAid2hhdG5vdC1pbWFnZXMiLCAia2V5IjogImxpdmVzdHJlYW1fdGh1bWJuYWlscy9jZTdmMzA0Yi1mMWI2LTRlZTMtYWI1Mi03Y…","trailer": null,"sponsored": false,"seller": {"username": "spacenarwhalz","id": "1957346","url": "https://www.whatnot.com/user/spacenarwhalz","image": "https://images.whatnot.com/eyJidWNrZXQiOiAid2hhdG5vdC1pbWFnZXMiLCAia2V5IjogInVzZXJzLzE5NTczNDYvNmM1YjBkMzctYjliNy00NDY2LTljOTktOGNlZGRkZmIwN…","premier_shop": true,"badges": []}},{"id": "145ce6ad-2ed8-41e9-b827-1d465765b1a7","url": "https://www.whatnot.com/live/145ce6ad-2ed8-41e9-b827-1d465765b1a7","title": "🇺🇸 🔥FREE PHANTASMAL CHARIZARD & RAPID FIRE SLABS 🔥","status": "PLAYING","start_time": "2026-11-04T04:03:24.704Z","viewers": 1772,"watchlist_users": 94,"categories": [{"label": "Pokémon Cards","slug": "pokemon_cards"}],"tags": ["$1 Starts","Sudden Death","… 1 more"],"labels": [],"thumbnail": "https://images.whatnot.com/eyJidWNrZXQiOiAid2hhdG5vdC1pbWFnZXMiLCAia2V5IjogImxpdmVzdHJlYW1fdGh1bWJuYWlscy9hODdhZjUzNy02MmVhLTRkNTctYWU2Zi00Y…","trailer": null,"sponsored": false,"seller": {"username": "novatcg","id": "1113397","url": "https://www.whatnot.com/user/novatcg","image": "https://images.whatnot.com/eyJidWNrZXQiOiAid2hhdG5vdC1pbWFnZXMiLCAia2V5IjogInVzZXJzLzExMTMzOTcvMjgzMjg0OTYtN2Q1OS00ODViLTk1NDUtMjlmYTVhYzc4Y…","premier_shop": true,"badges": []}},"… 22 more"],"sections": [],"facets": {"Time of Show": [{"label": "Live","value": "PLAYING","count": 406},{"label": "Upcoming","value": "CREATED","count": 94477}],"Show Format": [{"label": "Breaks","value": "primary_show_format_breaks","count": 19896},{"label": "Graded","value": "primary_show_format_graded","count": 1},"… 2 more"],"Tag": [{"label": "Pokémon","value": "97","count": 42068},{"label": "$1 Starts","value": "2290","count": 40265},"… 73 more"],"Seller Rating": [{"label": "5 stars","value": "5.0","count": 58729},{"label": "4.5 & Up","value": "4.5","count": 86397},"… 1 more"],"Premier Shop": [{"label": "Premier Shop","value": "true","count": 13100}],"Shipped From": [{"label": "United States","value": "US","count": 63020},{"label": "United Kingdom","value": "GB","count": 16123},"… 8 more"]},"sorts": ["Recommended","Viewers: high to low","… 1 more"],"cached": false,"credits_used": 1} What you can build with the Whatnot API
Live shopping market research
Log /whatnot/v1/categories through the day to see which categories draw the most viewers, then open the busiest with /whatnot/v1/live sorted by viewers to see which shows and sellers lead them.
Competitor seller tracking
Check rival shops with /whatnot/v1/user for rating, reviews, items sold, followers and average ship days, and see when they go live and what their upcoming shows are called.
Scheduling your own shows
List a category's upcoming shows sorted by start_time to see when other sellers stream, and pick slots with less competition for the audience you want.
Seller sourcing for brands and agencies
Find active sellers in trading cards, comics or coins from the live listings, then vet each one's verified status, premier shop badge and review count before partnering.
Category facet analysis
The facets on each category page come with counts for sub-categories, show format, tags, seller rating and where items ship from, which shows how a category's supply is spread at that moment.
Whatnot data you get
Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.
Whatnot API endpoints and prices
Every Whatnot endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing
| Whatnot seller /whatnot/ | $1 · $2 PAYG 1 credit |
| Whatnot live shows by category /whatnot/ | $1 · $2 PAYG 1 credit |
| Whatnot categories /whatnot/ | $1 · $2 PAYG 1 credit |
Call the Whatnot API
Whatnot live shows by category: GET https://api.api.sh/whatnot/
curl "https://api.api.sh/whatnot/v1/live?category=pokemon_cards" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/whatnot/v1/live",
params={"category": "pokemon_cards"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/whatnot/v1/live");
url.searchParams.set("category", "pokemon_cards");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); # Google Sheets (API.SH add-on)
=APISH("/whatnot/v1/live", "category", "pokemon_cards")
# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Whatnot" and "Whatnot live shows by category".
# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp - Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
- Create an API keyOne key works for all 918 platforms.
- Send the requestJSON back in one call. Add
output=csvoroutput=ndjsonfor files.
Why API.SH for Whatnot data
- Public data only: no Whatnot login, cookies or account needed
- One key and one response shape for Whatnot and 917 other platforms
- Built and maintained by API.SH, not third-party publishers
- Pay per call; errors on our side cost nothing
- No rate limits: run as many calls in parallel as you need
- Live status for every endpoint
API.SH vs the official Whatnot API
Whatnot's Seller API, a GraphQL API with webhooks, is open to sellers approved to sell live and works on their own shop: catalog, inventory, livestreams and orders. It does not give market data on other sellers or categories. API.SH reads those public pages instead, with no seller approval.
Several Apify actors scrape Whatnot listings and streams priced per result; API.SH returns categories, shows and seller profiles per call in the same JSON style as its eBay, TCGplayer and other marketplace endpoints.
Whatnot API questions
What Whatnot data can I get?+
Categories with live watcher counts (/whatnot/v1/categories), live and upcoming shows in a category with viewers, sellers and filter facets (/whatnot/v1/live), and a seller's shop profile with rating, items sold, ship days and shows (/whatnot/v1/user).
How much does the Whatnot API cost?+
Every Whatnot endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.
Is there a free trial?+
Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /whatnot/v1/categories at 1 credit each.
Does Whatnot have an open API?+
Whatnot has a Seller API for approved live sellers to manage their own products, orders and streams. There is no open API for browsing other shows or sellers, which is what these endpoints cover.
Do I need a Whatnot seller account?+
No. A category slug or a seller username is all you pass, with your API.SH key. Order history, payouts and anything only a signed-in seller sees are not available; accounts that do not sell answer 404 on the seller route.
Can I see how many people are watching a Whatnot show?+
Yes. Each show from /whatnot/v1/live has its current viewers and watchlist count, and sort=viewers puts the most watched first. The items and bids inside a show are not returned.
Can I use the Whatnot API from Python?+
Yes. Send a GET request with your key from requests or httpx, or install the API.SH Python SDK; responses are plain JSON with the same field names every time.
How do I get started?+
1. Sign up at api.sh. 2. Copy your API key. 3. Call /whatnot/v1/categories, take a name from the result and pass it as category to /whatnot/v1/live with status=live. Every parameter is in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.
Does the Whatnot API have a rate limit?+
No. API.SH puts no rate limit on your key: send as many Whatnot calls in parallel as you need and pay only for the calls that run. If Whatnot itself slows down, the call returns 503 with a retry-after header and is not charged.