# Whatnot API scraper - the US/UK live-stream shopping marketplace: search products, live and scheduled auction shows, sellers and category tags; full product records with price, condition and seller reputation; live show records with viewer count and start time; every show a seller has coming up. No account, no browser.

> Search Whatnot by keyword. Choose the tab with `vertical`: products (buy-it-now and auction listings with price, condition attributes and seller reputation), shows (live and scheduled auction streams with viewer count and start time), users (sellers with rating, followers and items sold), categories (Whatnot's own category tags) or all (Whatnot's mixed 'Top' feed). Whatnot serves roughly 24 rows per query on this surface and reports whether it has more. Whatnot does not publish a running bid for auction items outside the show itself, so no bid field is returned.
> ReefAPI engine `whatnot` · 5 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/whatnot/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/whatnot/v1/search — 1 credit
Search Whatnot by keyword. Choose the tab with `vertical`: products (buy-it-now and auction listings with price, condition attributes and seller reputation), shows (live and scheduled auction streams with viewer count and start time), users (sellers with rating, followers and items sold), categories (Whatnot's own category tags) or all (Whatnot's mixed 'Top' feed). Whatnot serves roughly 24 rows per query on this surface and reports whether it has more. Whatnot does not publish a running bid for auction items outside the show itself, so no bid field is returned.

**Parameters:**
- `query` (string, required) — What to search for on Whatnot - a keyword, brand, card set, player or seller name.
- `vertical` (enum, optional, default "all") — Which Whatnot search tab to read. An unknown value is rejected here because the site would silently answer with the mixed 'all' feed instead. [one of: all, products, shows, users, categories]

**Returns:** query, vertical, feed_title, results[] {type: product, listing_id, url, title, subtitle, description, price (major units), price_minor (the source's own integer), currency, status, transaction_type, quantity, images[], image, rating (null - Whatnot rates the seller, not the item), review_count (null), seller{username, url, and whichever of user_id, display_name, seller_rating, review_count, follower_count, following_count, sold_count, average_ship_days, is_live, is_verified_seller, is_premier_shop, can_go_live, ships_from_country, profile_image, bio this surface serves}, is_live (search only: the item is in a show running right now)} for products, {type: show, livestream_id, url, title, status (PLAYING = live now, CREATED = scheduled), is_live, start_time, active_viewers (point-in-time), categories[]{tag, label, url}, tags[], thumbnail, trailer_url, stream_service, seller{username, url, and whichever of user_id, display_name, seller_rating, review_count, follower_count, following_count, sold_count, average_ship_days, is_live, is_verified_seller, is_premier_shop, can_go_live, ships_from_country, profile_image, bio this surface serves}, total_watchlist_users (feed only, point-in-time)} for shows, {type: user, …} for users, {type: category, tag, label, url, viewer_count} for categories, count, has_more (Whatnot has further rows that only its in-app feed serves), shelves[] (category tiles the 'all' feed mixes in; never counted as results), spelling_correction, measured_at

**Example request body:**
```json
{
  "query": "pokemon",
  "vertical": "products"
}
```

### POST https://api.reefapi.com/whatnot/v1/product/detail — 1 credit
One Whatnot product listing in full: title, description, price, quantity, condition and the seller's own attributes (set, language, grade, rarity where the category has them), every image, when it was listed, whether offers are accepted, whether it is pinned in a show that is running right now, and the seller's public reputation (rating, reviews, followers, items sold, average ship days). Whatnot does not publish a running bid on the listing page.

**Parameters:**
- `listing_id` (string, required) — Whatnot listing id - the value after /listing/ in the URL. A full listing URL or the plain numeric id also works.

**Returns:** item {type: product, listing_id, url, title, subtitle, description, price (major units), price_minor (the source's own integer), currency, status, transaction_type, quantity, images[], image, rating (null - Whatnot rates the seller, not the item), review_count (null), seller{username, url, and whichever of user_id, display_name, seller_rating, review_count, follower_count, following_count, sold_count, average_ship_days, is_live, is_verified_seller, is_premier_shop, can_go_live, ships_from_country, profile_image, bio this surface serves}, attributes{} (condition, set, language, grade… where the category has them), created_at, discounted_price, discounted_price_minor, active_livestream_id (the show the item is pinned in, when one is running), accepts_offers, auction_end_time (Whatnot's own auction handle; it was unset on every listing measured), view_only, allows_right_of_withdrawal}, page_price (the price Whatnot's own schema.org block prints on the same page), price_disagrees_with_page (true when the two disagree - the number is then reported, never silently picked), measured_at

**Example request body:**
```json
{
  "listing_id": "TGlzdGluZ05vZGU6MjM2MDA2ODU0Mg=="
}
```

### POST https://api.reefapi.com/whatnot/v1/user/profile — 1 credit
One Whatnot seller's public profile: display name, bio, rating and review count, followers, following, items sold, average ship days, verified and Premier Shop status - plus every show they currently have live or scheduled, with start time and viewer count.

**Parameters:**
- `username` (string, required) — Whatnot username - the name after /user/ in the profile URL. A full profile URL also works.

**Returns:** user{type: user, username, url, display_name, user_id, seller_rating, review_count, follower_count, following_count, sold_count, average_ship_days, is_live, is_verified_seller, is_premier_shop, profile_image, bio, can_go_live}, shows[] {type: show, livestream_id, url, title, status (PLAYING = live now, CREATED = scheduled), is_live, start_time, active_viewers (point-in-time), categories[]{tag, label, url}, tags[], thumbnail, trailer_url, stream_service, seller{username, url, and whichever of user_id, display_name, seller_rating, review_count, follower_count, following_count, sold_count, average_ship_days, is_live, is_verified_seller, is_premier_shop, can_go_live, ships_from_country, profile_image, bio this surface serves}, total_watchlist_users (feed only, point-in-time)}, show_count, measured_at

**Example request body:**
```json
{
  "username": "collectibletags"
}
```

### POST https://api.reefapi.com/whatnot/v1/category/shows — 1 credit
The live and scheduled shows of one Whatnot category tag (e.g. pokemon_cards, sneakers, sports_cards), each with its seller, start time, viewer count, categories and tags - the closest thing Whatnot has to a live auction calendar for a collecting niche.

**Parameters:**
- `tag` (string, required) — Whatnot category tag - the name after /tag/ in the URL, e.g. pokemon_cards. `search` with vertical=categories finds the tag name for a keyword.

**Returns:** tag, feed_title, shows[] {type: show, livestream_id, url, title, status (PLAYING = live now, CREATED = scheduled), is_live, start_time, active_viewers (point-in-time), categories[]{tag, label, url}, tags[], thumbnail, trailer_url, stream_service, seller{username, url, and whichever of user_id, display_name, seller_rating, review_count, follower_count, following_count, sold_count, average_ship_days, is_live, is_verified_seller, is_premier_shop, can_go_live, ships_from_country, profile_image, bio this surface serves}, total_watchlist_users (feed only, point-in-time)}, count, has_more, suggested_tags[]{tag, label, url}, measured_at

**Example request body:**
```json
{
  "tag": "pokemon_cards"
}
```

### POST https://api.reefapi.com/whatnot/v1/livestream/detail — 1 credit
One Whatnot show: title, whether it is playing right now or still scheduled, its start time, how many people are watching at this moment, its categories and tags, thumbnail, and the seller running it with their follower and sold counts.

**Parameters:**
- `livestream_id` (string, required) — Whatnot show id - the uuid after /live/ in the show URL. A full show URL also works.

**Returns:** show {type: show, livestream_id, url, title, status (PLAYING = live now, CREATED = scheduled), is_live, start_time, active_viewers (point-in-time), categories[]{tag, label, url}, tags[], thumbnail, trailer_url, stream_service, seller{username, url, and whichever of user_id, display_name, seller_rating, review_count, follower_count, following_count, sold_count, average_ship_days, is_live, is_verified_seller, is_premier_shop, can_go_live, ships_from_country, profile_image, bio this surface serves}, ships_from_country (show page only)}, pinned_product_id, buyer_shop_enabled, measured_at

**Example request body:**
```json
{
  "livestream_id": "14a5c3bb-c44b-4a98-8432-4e8d97c10f1b"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=whatnot
- Human docs page: https://reefapi.com/docs/whatnot
- Overview page: https://reefapi.com/whatnot-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
