Whatnot API Documentation

First request

Endpoint

GET /whatnot/browse

Cost

3 credits/request

curl "https://api.crawlora.net/api/v1/whatnot/browse?category=trading_card_games" \
  -H "x-api-key: $CRAWLORA_API_KEY"

How to use Whatnot endpoints

Crawlora's Whatnot endpoints return category browsing, a live show's current shop feed, and public seller profile data with public livestream cards as normalized JSON using a Crawlora API key. The new /whatnot/seller/{username} route is a profile-and-show archive, not a shop product listing or seller search: it returns at most 15 shows per call and uses an opaque cursor copied unchanged from next_cursor while has_more is true. Preserve total_count as a changing source count, and do not assume that a profile's show list includes every ended stream.

1. Step 1

   Get the category slugs first

   /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.

2. Step 2

   Browse live shows by slug

   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.

3. Step 3

   Read show status and timing

   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.

4. Step 4

   Get a live show's feed

   Pass a show id from /whatnot/browse to /whatnot/live/{id} for that show's current shop feed — items up for sale and pricing.

5. Step 5

   Read a seller profile and show history

   Pass a Whatnot username to /whatnot/seller/{username}. The response combines public profile fields with at most 15 public livestream cards; follow next_cursor unchanged only while has_more is true. It does not return product listings or add sorting/filter parameters.

6. Step 6

   Monitor or aggregate

   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.

7. Step 7

   Browse shows by category and seller

   On 2026-10-30 /whatnot/categories returned 35 categories, browse for trading_card_games returned 24 shows with status and start_time_ms, and the seller fluffcardhouse returned 14 shows with has_more false.

Other Marketplaces & Retail APIs