Whatnot API endpoint
Returns public seller profile details and one page of the seller's livestreams. Use next_cursor as cursor to continue while has_more is true. The endpoint does not include shop products.
/whatnot/seller/{username}Returns public seller profile details and one page of that seller's public livestreams. It does not return shop product listings, shop search, filters, or sorting.
Path parameters:
username (required) — seller's Whatnot username.Query parameters:
cursor (optional) — opaque continuation cursor from the prior response's next_cursor. Omit it for the first page. Pass it back unchanged while has_more is true.The endpoint returns at most 15 shows per request. total_count is Whatnot's reported count at request time; it can change while paging. has_more reflects the upstream page's hasNextPage; next_cursor is provided only when another page exists. Profile fields are fetched from the public seller page; show pages are fetched from Whatnot's anonymous GetUserLiveStreams operation. Signed image URLs are omitted.
shows[].status values observed live are PLAYING (live) and CREATED (scheduled). This is a partial observed set: ended-show states were not present in seller show pages sampled for this round.
| Field | Filled in, of 15 checked | Values in the sample |
|---|---|---|
| id | 15 | |
| url | 15 | whatnot.com |
| title | 15 | |
| seller_username | 15 | |
| status | 15 | |
| start_time_ms | 15 | 2026-10-13 to 2026-10-16 |
| tags | 15 | median 3 entries |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| username (path) | string | Yes | Whatnot seller username | fluffcardhouse | |
| cursor | string | No | Opaque cursor from a prior response's next_cursor | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/whatnot/seller/fluffcardhouse" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"profile": {
"username": "fluffcardhouse",
"display_name": "Fluff",
"bio": "Public seller bio",
"follower_count": 303328,
"following_count": 3,
"average_ship_days": 0,
"rating": 4.9,
"review_count": 54924,
"sold_count": 251071,
"is_live": true,
"is_verified_seller": false,
"is_premier_shop": true
},
"shows": [
{
"id": "example-id",
"url": "https://www.whatnot.com/live/example-id",
"title": "Cards",
"seller_username": "fluffcardhouse",
"status": "PLAYING"
}
],
"total_count": 21,
"has_more": true,
"next_cursor": "opaque-upstream-cursor"
}
}Request schema
No body schema
Response schema
#/definitions/whatnot.sellerResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | whatnot.SellerResponse | No | ||||
| data.has_more | boolean | No | ||||
| data.next_cursor | string | No | ||||
| data.profile | whatnot.SellerProfile | No | ||||
| data.profile.average_ship_days | integer | No | ||||
| data.profile.bio | string | No | ||||
| data.profile.display_name | string | No | ||||
| data.profile.follower_count | integer | No | ||||
| data.profile.following_count | integer | No | ||||
| data.profile.is_live | boolean | No | ||||
| data.profile.is_premier_shop | boolean | No | ||||
| data.profile.is_verified_seller | boolean | No | ||||
| data.profile.rating | number | No | ||||
| data.profile.review_count | integer | No | ||||
| data.profile.sold_count | integer | No | ||||
| data.profile.username | string | No | ||||
| data.shows | array | No | LiveShow record, 8 fields: id, seller_username, start_time_ms, status, tags, thumbnail_url, title, url. Described under Whatnot browse API. | |||
| data.total_count | integer | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/whatnot/seller/fluffcardhouse" \
-H "x-api-key: $CRAWLORA_API_KEY"