{ "openapi": "3.0.1", "info": { "title": "Whatnot Seller Tracker for Top Sellers and Sales", "description": "Track Whatnot sellers: top sellers per category from Whatnot's own leaderboard, exact items sold, sales per day since your last check, followers, rank changes, rating, shipping time, bio links and next show. 8 marketplaces. No login. $3 per 1,000 sellers. Maintained by CleanScrape.", "version": "0.1", "x-build-id": "yxD2WNdx4vbhSRSBn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cleanscrape~whatnot-seller-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cleanscrape-whatnot-seller-tracker", "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/cleanscrape~whatnot-seller-tracker/runs": { "post": { "operationId": "runs-sync-cleanscrape-whatnot-seller-tracker", "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/cleanscrape~whatnot-seller-tracker/run-sync": { "post": { "operationId": "run-sync-cleanscrape-whatnot-seller-tracker", "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": { "categories": { "title": "Categories (top sellers)", "type": "array", "description": "Whatnot categories whose top sellers you want, from Whatnot's own seller leaderboard. Type a name (\"Pokémon Cards\", \"Sneakers & Shoes\", \"Women's Fashion\") or paste a category link such as https://www.whatnot.com/tag/sports_cards.", "items": { "type": "string" } }, "sellers": { "title": "Sellers", "type": "array", "description": "Sellers to track: usernames (with or without @), profile links such as https://www.whatnot.com/user/, or a link to one of their live shows. Use this, Categories, or both.", "items": { "type": "string" } }, "marketplace": { "title": "Marketplace", "enum": [ "us", "ca", "gb", "de", "fr", "be", "nl", "au" ], "type": "string", "description": "Whatnot shows different sellers, leaderboards and currencies per country. Marketplaces other than the United States use a residential connection in that country.", "default": "us" }, "leaderboardPeriod": { "title": "Leaderboard period", "enum": [ "week", "day" ], "type": "string", "description": "Which of Whatnot's leaderboards ranks the top sellers.", "default": "week" }, "topSellers": { "title": "Top sellers per category", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many sellers to take from each category's leaderboard, from rank 1 down. Whatnot ranks up to about 500.", "default": 50 }, "includeShows": { "title": "Next show", "type": "boolean", "description": "Adds when each seller goes live next, the show title and how many shows are scheduled. Included in the seller price.", "default": true }, "maxShowsPerSeller": { "title": "Shows per seller (table)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Saves each seller's live and upcoming shows, soonest first (with viewers, format and tags), in the Shows table. Whatnot does not show ended shows without login. 0 = none.", "default": 0 }, "maxReviewsPerSeller": { "title": "Reviews per seller", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Newest seller reviews to save per seller (0 = none).", "default": 0 }, "maxShopListingsPerSeller": { "title": "Shop listings per seller", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Listings from each seller's shop to save, with asking prices (0 = none).", "default": 0 }, "compareWithPrevious": { "title": "Compare with my previous run", "type": "boolean", "description": "Adds sold since last check, sold per day, followers change and rank change, compared with the last time any of your runs checked the same seller in the same marketplace. Schedule the Actor daily or weekly to track trends.", "default": true }, "historyName": { "title": "History name (optional)", "type": "string", "description": "Keeps a separate history, for example \"Client A\" or \"Pokemon daily\". Leave empty to use one shared history per marketplace." } } }, "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 } } } } } } } } } }