Scrape Whatnot listings and sellers — prices, bids, conditions, card attributes (Set, Grade, Year), seller ratings, sold counts, and full shop inventory. Search, browse categories, or walk seller shops. Incremental price-change tracking with JSON and CSV export.
No credit card required. No commitment. Cancel anytime.
- Click sign up — pick GitHub, Google, or email; takes ~30 seconds
- Open this actor — input is pre-filled with a working example
- Click Start — export results as JSON, CSV, or Excel
Your $5 monthly platform credit is enough to run this actor right away — and again every month — scraping typically several hundred to several thousand results per run, depending on your input.
Export anywhere — Download as JSON, CSV, or Excel. Stream via Apify API, webhooks, or integrations with Make, Zapier, Airbyte, Keboola.
Structured data — Every listing returns the same schema with consistent field naming. All fields always present — null when unavailable, never omitted.
Data pipeline automation Integrate with your ETL pipeline to collect structured listings from the source on a schedule. Export to CSV, JSON, or directly to your database.
Market research Monitor listings, track trends, and analyze market dynamics with structured, deduplicated data from the source.
AI / LLM training data Structured JSON per listing is ready for RAG pipelines, embeddings, and agent workflows. Compact mode trims tokens for LLM context windows.
{
"searchKeywords": [
"pokemon cards"
],
"maxItems": 10
}| Parameter | Type | Default | Description |
|---|---|---|---|
searchKeywords |
array | — | One or more search terms. Each keyword produces an independent set of results. |
categories |
array | — | One or more Whatnot category slugs (e.g. "trading-cards", "sneakers"). Leave empty to search across all categories. |
sellerUrls |
array | — | Whatnot seller profile URLs (e.g. https://www.whatnot.com/user/bob). The actor scrapes all active listings in each seller's shop. |
startUrls |
array | — | Direct listing URLs or search result pages to scrape. Useful for targeting specific items or saved searches. |
listingType |
enum | "all" |
Filter by transaction type: all types, auctions only, or fixed-price buy-now listings only. |
status |
enum | "active" |
Filter by listing status: active listings, currently-live shows, sold listings, or all. |
condition |
string | — | Filter by item condition (e.g. "new", "like_new", "good", "fair"). Leave empty for all conditions. |
priceMin |
number | — | Minimum listing price in US dollars. Listings below this price are excluded. |
priceMax |
number | — | Maximum listing price in US dollars. Listings above this price are excluded. |
sort |
enum | "best_match" |
How to sort the results: best match, newest listings, ending soonest (auctions), price low-to-high, or price high-to-low. |
onlyLive |
boolean | false |
When enabled, return only listings attached to a currently live show. |
minDiscountPercent |
number | — | Minimum discount percentage (0–100). Only listings with at least this discount are included. |
offerableOnly |
boolean | false |
When enabled, only include listings where the seller accepts offers. |
quantityMin |
integer | — | Minimum available quantity. Only listings with at least this many units in stock are included. |
maxItems |
integer | 0 |
Maximum total listings to return (0 = unlimited). Applies across all sources combined. |
maxListingsPerSeller |
integer | 0 |
Maximum listings to collect from each seller's shop (0 = unlimited). |
maxSellers |
integer | 0 |
Maximum number of sellers to process from sellerUrls (0 = all provided sellers). |
includeSellerProfiles |
boolean | false |
Fetch and emit the seller's full profile (bio, follower count, ratings, social links) alongside their listings. |
includeListingDetails |
boolean | true |
Fetch the full listing detail page for each result — adds full description, all images, condition notes, and structured attributes. |
includeProductAggregates |
boolean | false |
Add product-level price range data (min/max across all variants) when available. |
descriptionFormat |
enum | "all" |
Format for the description field: all (text + html + markdown), text only, html only, or markdown only. |
excludeEmptyFields |
boolean | false |
Remove null and empty fields from the output to reduce dataset size. |
includeRunMetadata |
boolean | false |
Append run metadata (actor version, run ID, scrape timestamp) to each output record. |
telegramToken |
string | — | Telegram bot token (from @BotFather). Required for Telegram notifications. |
telegramChatId |
string | — | Telegram chat or channel ID (e.g. "-100123456789"). Required when telegramToken is set. |
discordWebhookUrl |
string | — | Discord incoming webhook URL. Server Settings → Integrations → Webhooks → New Webhook. |
slackWebhookUrl |
string | — | Slack incoming webhook URL. api.slack.com/messaging/webhooks. |
notificationLimit |
integer | 5 |
Maximum number of listings included in each notification message (1–20). |
notifyOnlyChanges |
boolean | false |
Only send notifications for NEW and UPDATED listings when incremental mode is active. |
whatsappAccessToken |
string | — | WhatsApp Cloud API permanent access token (System User token from Meta Business). |
whatsappPhoneNumberId |
string | — | Your WhatsApp Business phone-number ID (numeric, from Meta dashboard). Required when whatsappAccessToken is set. |
whatsappTo |
string | — | Recipient phone in E.164 format without + (e.g. "436641234567"). |
webhookUrl |
string | — | Receives a JSON POST with {metadata, items} after each run. Works with n8n, Make, Zapier, and custom backends. |
webhookHeaders |
object | — | Optional JSON object of custom HTTP headers sent with the webhook (e.g. {"Authorization":"Bearer ..."}). |
Every listing returns the same 37-field schema. Missing values are null — never omitted.
typeidurltitledescriptiondescriptionHtmldescriptionMarkdownimagesvideoslistingTypestatuspricediscountedPricediscountPercenttopBidbidCountstartingBidbuyNowPricecurrencyquantityisOfferableconditionattributescategorycategoryPathhashtagsshippingPriceshipsFromproductIdsellershowIdshowTitleisLivescheduledStartTimecreatedAtendedAtlifecycle
One object per listing. Here is a real example from a production run:
{
"type": "listing",
"id": "TGlzdGluZ05vZGU6MTgzNjcyMDY4MA==",
"url": "https://www.whatnot.com/listing/TGlzdGluZ05vZGU6MTgzNjcyMDY4MA==",
"title": "Bulbizarre Pokémon go",
"description": "Pogo",
"descriptionHtml": "<p>Pogo</p>",
"descriptionMarkdown": "Pogo",
"images": [
"https://images.whatnot.com/eyJidWNrZXQiOiAid2hhdG5vdC1pbWFnZXMiLCAia2V5IjogImxpc3RpbmdzLzAtMTRlZmFhZDQtN2ZmNS00NGRhLTg2M2QtOTc5N2Y0NjIzNTc1LTU1N2MzOWNkLTBiYjEtNGQyZi05ZTk1LTAxNTczYjkxNmYyYy5qcGVnIiwgImVkaXRzIjogeyJyZXNpemUiOiB7IndpZHRoIjogbnVsbCwgImhlaWdodCI6IG51bGwsICJmaXQiOiAiY29udGFpbiIsICJiYWNrZ3JvdW5kIjogeyJyIjogMjU1LCAiZyI6IDI1NSwgImIiOiAyNTUsICJhbHBoYSI6IDF9fX19?signature=912f3da73890d569cbe4f8bbc38e231a88cbe1bfca3627fe3ea7bda829bb2626"
],
"videos": [],
"listingType": "BUY_IT_NOW",
"status": "ACTIVE",
"price": 2
}Truncated — full records contain 37 fields. See Output fields for the complete schema.
Try Whatnot Scraper now — $5 free credit, no credit card →
Pay only for what you extract. No subscription required — Apify's free $5 credit covers thousands of results.
| Event | Price (USD) |
|---|---|
| Actor Start | $0.005 |
| Result | $0.004 |
See the actor on Apify for current pricing.
How much does it cost? Pay-per-event pricing — you only pay for listings extracted. Apify's free $5 credit is enough to run thousands of results before you pay anything.
Do I need an API key or credentials? No. Just sign up for Apify, paste your input, and click Start. No credit card required.
- Reddit Scraper — Reddit posts, comment threads, users and communities
Browse all Black Falcon Data actors →
New to Apify? Create a free account with $5 credit — no credit card required.
- Sign up — $5 platform credit included
- Open Whatnot Scraper and configure your input
- Click Start — export results as JSON, CSV, or Excel
Need more later? See Apify pricing.
Black Falcon Data builds production-grade web scrapers for job boards and marketplace data. Browse our full actor catalog at www.blackfalcondata.com.
Last updated: 2026 06