{ "openapi": "3.0.1", "info": { "title": "Whatnot Seller Scraper", "description": "Extract seller information from Whatnot.com - Scrape seller profiles, products, reviews, and livestreams for market research, competitor analysis, and lead generation.", "version": "0.0", "x-build-id": "BMQhOaI9yxTgA2lrW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/devcake~whatnot-seller-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-devcake-whatnot-seller-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/devcake~whatnot-seller-scraper/runs": { "post": { "operationId": "runs-sync-devcake-whatnot-seller-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/devcake~whatnot-seller-scraper/run-sync": { "post": { "operationId": "run-sync-devcake-whatnot-seller-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", "required": [ "searchQueries" ], "properties": { "sellerUrls": { "title": "Search by URLs", "uniqueItems": true, "type": "array", "description": "Whatnot URLs to process. Supports: Complex search URLs with filters - searches products and extracts sellers. Direct profile URLs - fetch seller directly. Simple search URLs without filters are ignored (use searchQueries instead).", "items": { "type": "string" }, "default": [] }, "searchQueries": { "title": "Search Queries", "minItems": 1, "uniqueItems": true, "type": "array", "description": "Keywords to search for sellers. Multiple queries will be combined and URL results are deduplicated by seller ID. Use specific niches for better results. Can be used alone or with seller URLs.", "items": { "type": "string" }, "default": [ "sneakers" ] }, "fetchProducts": { "title": "Fetch Products", "type": "boolean", "description": "Include seller's product listings. Products include title, price, quantity, images, condition, and availability status. Additional fee: $0.0025 per product extracted.", "default": false }, "fetchReviews": { "title": "Fetch Reviews", "type": "boolean", "description": "Include customer reviews with ratings, comments, timestamps, and seller responses. Essential for reputation analysis. Additional fee: $0.0025 per review extracted.", "default": false }, "fetchStreams": { "title": "Fetch Livestreams", "type": "boolean", "description": "Include livestream history with status, viewer counts, tags, categories, and scheduling information. Additional fee: $0.0025 per stream extracted.", "default": false }, "maxSellers": { "title": "Max Sellers (Total)", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of unique sellers to scrape across ALL sources (URLs + queries combined). Higher values = longer run times.", "default": 50 }, "maxProductsPerSeller": { "title": "Max Products per Seller", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Maximum number of products to fetch per seller. Set to 0 for unlimited (fetches all available).", "default": 10 }, "maxReviewsPerSeller": { "title": "Max Reviews per Seller", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Maximum number of reviews to fetch per seller. Set to 0 for unlimited (fetches all available).", "default": 10 }, "maxStreamsPerSeller": { "title": "Max Streams per Seller", "minimum": 0, "maximum": 500, "type": "integer", "description": "Maximum number of livestreams to fetch per seller. Set to 0 for unlimited (fetches all available).", "default": 20 } } }, "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 } } } } } } } } } }