{ "openapi": "3.0.1", "info": { "title": "πŸš€ Whatnot Scraper Β· 5,000 Free Listings/Month", "description": "Whatnot Scraper gets you Whatnot listings ⚑ fast, 🎯 100% accurate and πŸ” ridiculously detailed β€” prices, formats, images, sellers and item attributes. πŸ’° $1 per 1,000 listings, no start fee. Scrape your first 5,000 listings free every month πŸš€", "version": "0.0", "x-build-id": "3DPWaO2tcdARAWV9R" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/omkar-cloud~whatnot-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-omkar-cloud-whatnot-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/omkar-cloud~whatnot-scraper/runs": { "post": { "operationId": "runs-sync-omkar-cloud-whatnot-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/omkar-cloud~whatnot-scraper/run-sync": { "post": { "operationId": "run-sync-omkar-cloud-whatnot-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": { "searchQueries": { "title": "Search Keywords", "type": "array", "description": "Keywords to search for β€” each is searched separately. Rows carry a `search_query` field so you can tell keywords apart. Leave empty to scrape only seller shops.", "items": { "type": "string" } }, "sellers": { "title": "Sellers", "type": "array", "description": "Whatnot usernames (with or without @) or whatnot.com profile links β€” one shop each. Rows carry a `source_seller` field so you can tell shops apart.", "items": { "type": "string" } }, "maxResults": { "title": "Max Listings per Keyword / Seller", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of listings to scrape for each keyword and each seller. Use this to control your cost (1,000 listings β‰ˆ $1).", "default": 100 }, "includeDetails": { "title": "Include Full Listing Details", "type": "boolean", "description": "When enabled, every listing is also scraped in full β€” category, item attributes (condition, grade, set, size…), variant options, offer rules, auction settings, videos, the product, the seller's full profile (followers, items sold, ship time, country), the shows it is sold in and similar listings. Still one dataset row per listing: 1,000 detailed listings β‰ˆ $3 vs $1 standard. Runs take longer because each listing is fetched individually.", "default": false }, "sort": { "title": "Sort By", "enum": [ "best_match", "price_low_to_high", "price_high_to_low", "newest" ], "type": "string", "description": "Order of the listings.", "default": "best_match" }, "buyingFormat": { "title": "Buying Format", "enum": [ "", "buy_it_now", "auction" ], "type": "string", "description": "Keep only fixed-price items or only auction items. Leave on All for both.", "default": "" }, "category": { "title": "Category", "type": "string", "description": "Only listings in this category: a category slug (pokemon_cards), a numeric category ID (907) or any whatnot.com category link (https://www.whatnot.com/tag/pokemon_cards)." }, "minPrice": { "title": "Min Price", "minimum": 0, "type": "number", "description": "Lowest price to include, in the listing's own currency." }, "maxPrice": { "title": "Max Price", "minimum": 0, "type": "number", "description": "Highest price to include, in the listing's own currency." }, "gradedOnly": { "title": "Graded Items Only", "type": "boolean", "description": "Keep only graded items (trading cards, comics).", "default": false }, "autographedOnly": { "title": "Autographed Items Only", "type": "boolean", "description": "Keep only autographed items.", "default": false }, "minSellerRating": { "title": "Min Seller Rating", "enum": [ "", "4", "4.5", "5" ], "type": "string", "description": "Only sellers rated at least this many stars.", "default": "" }, "premierShopOnly": { "title": "Premier Shops Only", "type": "boolean", "description": "Keep only listings from Whatnot Premier Shop sellers.", "default": false }, "sellerCountry": { "title": "Seller Country", "type": "string", "description": "Only sellers shipping from these countries: comma-separated 2-letter country codes, up to 10." }, "condition": { "title": "Condition", "type": "string", "description": "Item condition, comma-separated." }, "gradingService": { "title": "Grading Service", "type": "string", "description": "Grading company, comma-separated." }, "grade": { "title": "Grade", "type": "string", "description": "Card grade, comma-separated." }, "set": { "title": "Set", "type": "string", "description": "Card set, comma-separated." }, "rarity": { "title": "Rarity", "type": "string", "description": "Card rarity, comma-separated." }, "language": { "title": "Language", "type": "string", "description": "Card language, comma-separated." }, "productType": { "title": "Product Type", "type": "string", "description": "Product type, comma-separated." }, "cardNumber": { "title": "Card Number", "type": "string", "description": "Card number, comma-separated." }, "attributes": { "title": "Other Attributes", "type": "string", "description": "Any other item attribute Whatnot offers as a filter (sneaker size, brand, colorway…), as Name=Value pairs separated by semicolons, up to 10." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }