# Whatnot Search Scraper — Listings, Streams & Seller Data (`epicscrapers/whatnot-search-scraper`) Actor Extract Whatnot search results by keyword or URL. Get listings, live streams, products, seller profiles, and categories with prices, bids, and viewer counts. Run one query or many, across all verticals. Results come as clean JSON for market research, price monitoring, or competitor analysis etc. - **URL**: https://apify.com/epicscrapers/whatnot-search-scraper.md - **Developed by:** [Epic Scrapers](https://apify.com/epicscrapers) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Whatnot Search Scraper Extract Whatnot search results by keyword or URL. Get listings, live streams, products, seller profiles, and categories with prices, bids, and viewer counts. ### Use Cases - **Market research** — Monitor what's selling and at what price across categories on Whatnot - **Competitor analysis** — Track seller listings, pricing strategies, and product catalog - **Price monitoring** — Watch listing prices and auction bids over time - **Inventory tracking** — Keep an eye on product availability and new listings - **Lead generation** — Discover active sellers and their contact profiles - **Content research** — Find trending products and livestream topics ### Features - **Search Whatnot by keyword** — Run one or multiple text queries across any vertical - **Search Whatnot by URL** — Paste exact Whatnot search URLs with sort, filter, and vertical params - **Extract product listings** — Get titles, descriptions, prices, images, quantities, and transaction types - **Extract live streams** — Get active viewer counts, titles, statuses, and stream tokens - **Extract seller profiles** — Get usernames, follower counts, sold counts, and seller ratings - **Extract product catalog data** — Get product names, listing prices, last sale prices, and listing counts - **Extract categories and tags** — Get category labels, viewer counts, and deeplinks - **Search across all verticals** — UNIVERSAL mode returns a mixed result set of all types - **Run multiple queries in one go** — Each query gets its own result set, results are merged - **Combine URLs and queries** — Both sources run together, results interleaved - **Quick results with pagination** — Configurable result limits and per-query caps ### How It Works #### Search by Text Query Provide one or more search terms. Each query runs against the vertical you choose — or UNIVERSAL to search everything at once. Supported verticals: - **PRODUCT** — Individual item listings (buy-it-now and auction) - **LIVESTREAM** — Active live streams with viewer counts - **USER** — Seller profiles with ratings and stats - **CATEGORY** — Product categories and tags - **UNIVERSAL** — All of the above, results interleaved #### Search by URL Paste a Whatnot search URL directly. The scraper parses the URL's own query, vertical, sort, and referring source params — exactly as Whatnot uses them. Example URLs: ```` https://www.whatnot.com/search?query=pokemon\&searchVertical=PRODUCT https://www.whatnot.com/search?query=sneakers\&sort={"direction":"DESC","field":"VIEWER\_COUNT"} https://www.whatnot.com/search?query=magic+the+gathering\&searchVertical=LIVESTREAM ```` Each URL is independent — the vertical and type selection come from the URL itself, not global settings. #### Combined Search Run URLs and text queries together. Both execute in parallel and results are interleaved into a single output. ### Input | Field | Type | Description | |---|---|---| | `searchUrls` | string[] | Whatnot search URLs. Each URL is parsed for its own query, vertical, sort, and params. | | `searchQueries` | string[] | Search terms. Each runs against the selected vertical or UNIVERSAL. | | `vertical` | string | Content type filter for query searches. One of: UNIVERSAL, PRODUCT, LIVESTREAM, USER, CATEGORY. | | `maxResultsPerQuery` | integer | Each query or URL gets up to this many results. | | `cookies` | string | Browser cookies from an authenticated Whatnot session. | | `proxyConfiguration` | object | Apify proxy configuration. | At least one of `searchUrls` or `searchQueries` is required. #### Example Input ```json { "searchQueries": ["pokemon cards", "sneakers"], "vertical": "PRODUCT", "maxResultsPerQuery": 100 } ```` ### Output Each result is a structured object. The type field tells you what kind of result it is. #### Result Types **Listing** — A buy-it-now or auction item ```json { "type": "listing", "title": "Pokemon - Cards Dunsparce GG23/GG70 Crown Zenith", "subtitle": "Mint ∙ Crown Zenith", "description": "Pokemon - Cards Dunsparce GG23/GG70 Crown Zenith", "transactionType": "BUY_IT_NOW", "quantity": 1, "price": { "amount": 500, "currency": "GBP" }, "currentBid": null, "currentBidCount": null, "isLive": false, "images": [{ "url": "https://images.whatnot.com/..." }], "user": { "username": "mysteryraiders", "sellerRating": { "overall": 5, "numReviews": 145 } }, "searchQuery": "pokemon cards", "vertical": "PRODUCT", "scrapedAt": "2026-05-17T18:31:44.674Z" } ``` **Livestream** — An active live stream ```json { "type": "livestream", "title": "FREE EVOLVING SKIES GIVEAWAY", "status": "PLAYING", "startTime": 1779027948159, "activeViewers": 260, "thumbnail": { "smallImage": "https://images.whatnot.com/...", "biggerImage": "https://images.whatnot.com/..." }, "user": { "username": "qualitypulls" }, "tags": [ { "label": "Pokémon", "name": "pokemon" }, { "label": "$1 Starts", "name": "one_dollar_starts" } ], "searchQuery": "pokemon cards", "vertical": "LIVESTREAM", "scrapedAt": "2026-05-17T18:31:54.957Z" } ``` **Product** — A product catalog entry with aggregated pricing ```json { "type": "product", "name": "Pokemon Booster Pack", "image": { "url": "https://images.whatnot.com/..." }, "listingPrice": { "amount": 499, "currency": "USD" }, "lastSalePrice": { "amount": 450, "currency": "USD" }, "numListings": 12, "searchQuery": "pokemon cards", "vertical": "PRODUCT", "scrapedAt": "2026-05-17T18:31:55.000Z" } ``` **User** — A seller profile ```json { "type": "user", "username": "pokemoncards", "isFollowing": false, "followerCount": 186, "soldCount": null, "isLive": false, "sellerRating": null, "profileImage": { "url": "https://images.whatnot.com/..." }, "searchQuery": "pokemon cards", "vertical": "USER", "scrapedAt": "2026-05-17T18:31:54.914Z" } ``` **Category / Tag** — A product category or livestream tag with viewer count ```json { "type": "tag", "label": "Pokémon Cards", "name": "pokemon_cards", "viewerCount": 17726, "deeplink": "tag/pokemon_cards", "searchQuery": "pokemon cards", "vertical": "CATEGORY", "scrapedAt": "2026-05-17T18:31:54.894Z" } ``` #### Search Metadata The output array includes a `searchMeta` object attached to the array itself: ```json { "mode": "search", "sources": ["url", "query"], "totalResults": 47, "resultCounts": { "listing": 20, "livestream": 15, "user": 8, "tag": 4 }, "fetchedAt": "2026-05-17T18:31:55.000Z" } ``` - `mode` — Whether results came from URLs, queries, or both - `sources` — Which sources were used (url, query) - `totalResults` — Total count - `resultCounts` — Breakdown by result type - `fetchedAt` — ISO timestamp Results from URL-based searches also include: - `sourceUrl` — The original Whatnot search URL - `rawUrlParams` — All parsed URL parameters #### Common Fields Every result includes these fields regardless of type: - `type` — One of: listing, livestream, product, user, category, tag - `searchQuery` — The search term or URL query that produced this result - `vertical` — The search vertical (PRODUCT, LIVESTREAM, USER, CATEGORY) - `scrapedAt` — ISO 8601 scrape timestamp - `cursor` — Pagination cursor (internal use) ### FAQ #### Can I search multiple queries at once? Yes. Pass an array of search terms in `searchQueries`. Each query runs in sequence, results are merged. Each query fetches up to `maxResultsPerQuery` results. #### Can I combine URLs and text queries? Yes. Both `searchUrls` and `searchQueries` run together in parallel. Results are interleaved into a single output. #### What data can I extract from listings? Each listing includes: title, subtitle, description, price, currency, current bid, bid count, quantity, transaction type (buy-it-now or auction), live status, images, seller info with ratings, and scraped timestamp. #### Does this need a Whatnot account or login? No. Public search results are accessible without authentication. Cookies are optional and only needed for personalized results. #### What is UNIVERSAL vertical? UNIVERSAL searches across all content types (PRODUCT, LIVESTREAM, USER, CATEGORY) and interleaves the results so you get a mixed feed — similar to Whatnot's own default search experience. #### How are results from different queries combined? Results are collected per query up to the configured limits, then merged. When both URLs and queries are used, results are interleaved (alternating between sources). #### Can I control how many results per query? Yes. Set `maxResultsPerQuery` to the number of results you want per query or URL. Each query independently fetches up to that many results. #### What if I only want live streams? Set `vertical` to `LIVESTREAM` or use a URL with `searchVertical=LIVESTREAM`. This returns only active livestream results. #### What if I only want sellers? Set `vertical` to `USER`. This returns seller profiles with usernames, ratings, follower counts, and sold counts. ### Limitations - Public data only. Authenticated-only features (following, watchlists) are not available. - Result counts depend on Whatnot's search index. Extremely niche queries may return fewer results than requested. - Livestream results are snapshots — viewer counts change in real time on Whatnot. ### Support For issues, feature requests, or questions, open a discussion or issue on the repository. # Actor input Schema ## `searchUrls` (type: `array`): List of Whatnot search URLs (e.g. "https://www.whatnot.com/search?query=pokemon\&searchVertical=PRODUCT"). Each URL is parsed independently for query, vertical, sort, and other params. ## `searchQueries` (type: `array`): List of search terms (e.g. "pokemon cards", "sneakers"). Each query runs against the selected vertical (or UNIVERSAL for a mix of all types). Multiple queries run in sequence, results are merged. ## `vertical` (type: `string`): Filter search results to specific content types. UNIVERSAL searches across all types. Use LIVESTREAM for active streams, PRODUCT for catalog items, USER for seller profiles, or CATEGORY for product categories. Only applies to searchQueries; searchUrls use each URL's own searchVertical param. ## `maxResultsPerQuery` (type: `integer`): Each query or URL gets up to this many results. ## `cookies` (type: `string`): Browser cookies from an authenticated Whatnot.com session. Required for accessing personalized results and following status. To get cookies: log into Whatnot.com, open Dev Tools, copy the Cookie header from any request. ## `proxyConfiguration` (type: `object`): Select proxies to be used by your scraper. ## Actor input object example ```json { "searchUrls": [ "https://www.whatnot.com/search?query=pokemon&searchVertical=PRODUCT" ], "searchQueries": [ "pokemon cards" ], "vertical": "PRODUCT", "maxResultsPerQuery": 100, "proxyConfiguration": { "useApifyProxy": true } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchUrls": [ "https://www.whatnot.com/search?query=pokemon&searchVertical=PRODUCT" ], "searchQueries": [ "pokemon cards" ], "vertical": "PRODUCT", "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("epicscrapers/whatnot-search-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchUrls": ["https://www.whatnot.com/search?query=pokemon&searchVertical=PRODUCT"], "searchQueries": ["pokemon cards"], "vertical": "PRODUCT", "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("epicscrapers/whatnot-search-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchUrls": [ "https://www.whatnot.com/search?query=pokemon&searchVertical=PRODUCT" ], "searchQueries": [ "pokemon cards" ], "vertical": "PRODUCT", "proxyConfiguration": { "useApifyProxy": true } }' | apify call epicscrapers/whatnot-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=epicscrapers/whatnot-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Whatnot Search Scraper — Listings, Streams & Seller Data", "description": "Extract Whatnot search results by keyword or URL. Get listings, live streams, products, seller profiles, and categories with prices, bids, and viewer counts. Run one query or many, across all verticals. Results come as clean JSON for market research, price monitoring, or competitor analysis etc.", "version": "0.1", "x-build-id": "BZJ0p7ba1cQWPlWAm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/epicscrapers~whatnot-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-epicscrapers-whatnot-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/epicscrapers~whatnot-search-scraper/runs": { "post": { "operationId": "runs-sync-epicscrapers-whatnot-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/epicscrapers~whatnot-search-scraper/run-sync": { "post": { "operationId": "run-sync-epicscrapers-whatnot-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchUrls": { "title": "Search URLs", "type": "array", "description": "List of Whatnot search URLs (e.g. \"https://www.whatnot.com/search?query=pokemon&searchVertical=PRODUCT\"). Each URL is parsed independently for query, vertical, sort, and other params.", "items": { "type": "string" } }, "searchQueries": { "title": "Search Queries", "type": "array", "description": "List of search terms (e.g. \"pokemon cards\", \"sneakers\"). Each query runs against the selected vertical (or UNIVERSAL for a mix of all types). Multiple queries run in sequence, results are merged.", "items": { "type": "string" } }, "vertical": { "title": "Search Vertical", "enum": [ "UNIVERSAL", "LIVESTREAM", "PRODUCT", "USER", "CATEGORY" ], "type": "string", "description": "Filter search results to specific content types. UNIVERSAL searches across all types. Use LIVESTREAM for active streams, PRODUCT for catalog items, USER for seller profiles, or CATEGORY for product categories. Only applies to searchQueries; searchUrls use each URL's own searchVertical param.", "default": "PRODUCT" }, "maxResultsPerQuery": { "title": "Max Results Per Query / URL", "minimum": 1, "maximum": 10000000, "type": "integer", "description": "Each query or URL gets up to this many results.", "default": 100 }, "cookies": { "title": "Cookies (Optional)", "type": "string", "description": "Browser cookies from an authenticated Whatnot.com session. Required for accessing personalized results and following status. To get cookies: log into Whatnot.com, open Dev Tools, copy the Cookie header from any request." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by your scraper." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```