{ "openapi": "3.0.1", "info": { "title": "Whatnot Listing Search Scraper", "description": "Search Whatnot marketplace listings by keyword with 16 verified filters (graded, PSA, set, rarity, price, condition) and sorts. Price, format, seller and images per listing, up to 1,000 per query. No login needed.", "version": "0.0", "x-build-id": "Z2gaQaZCvy1xr4IkE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/romy~whatnot-listing-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-romy-whatnot-listing-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/romy~whatnot-listing-search-scraper/runs": { "post": { "operationId": "runs-sync-romy-whatnot-listing-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/romy~whatnot-listing-search-scraper/run-sync": { "post": { "operationId": "run-sync-romy-whatnot-listing-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", "required": [ "queries" ], "properties": { "queries": { "title": "Search queries", "type": "array", "description": "One or more search texts (e.g. `psa 10 charizard`). Each query is searched separately and every row carries the `query` it came from.", "items": { "type": "string" } }, "sort": { "title": "Sort order", "enum": [ "price_asc", "price_desc", "newest", "oldest" ], "type": "string", "description": "Leave empty for best match." }, "maxItemsPerQuery": { "title": "Max listings per query", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Whatnot never returns more than about 1,000 results per query, so 1,000 is the ceiling.", "default": 100 }, "includeDetails": { "title": "Include listing details", "type": "boolean", "description": "Fetch each listing's detail page to add description, category, attributes (condition, set, grade, ...), creation time, views and product. Billed as an extra `listing-detail` event per listing.", "default": false }, "category": { "title": "Category keys", "type": "array", "description": "Category key(s), e.g. `pokemon_cards`. Values inside one filter are OR.", "items": { "type": "string" } }, "buyingFormat": { "title": "Buying format", "enum": [ "BUY_IT_NOW", "LIVESTREAM_AUCTION" ], "type": "string", "description": "Fixed-price listings or live auctions only." }, "minSellerRating": { "title": "Minimum seller rating", "enum": [ "5.0", "4.5", "4.0" ], "type": "string", "description": "Minimum seller rating." }, "premierShop": { "title": "Premier Shop sellers only", "type": "boolean", "description": "Only Premier Shop sellers.", "default": false }, "sellerCountry": { "title": "Seller ship-from countries", "type": "array", "description": "Country code(s), e.g. `US`, `GB`, `FR`, `DE`, `CA`, `AU`.", "items": { "type": "string" } }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "number", "description": "In major units (e.g. dollars); compared on a currency-normalised price." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "number", "description": "In major units (e.g. dollars)." }, "graded": { "title": "Graded only", "type": "boolean", "description": "Only graded items (trading cards).", "default": false }, "autographed": { "title": "Autographed only", "type": "boolean", "description": "Only autographed items.", "default": false }, "condition": { "title": "Condition", "type": "array", "description": "e.g. `Near Mint`.", "items": { "type": "string" } }, "language": { "title": "Language", "type": "array", "description": "e.g. `English`, `Japanese`.", "items": { "type": "string" } }, "productType": { "title": "Product type", "type": "array", "description": "e.g. `Card`, `Booster Box`.", "items": { "type": "string" } }, "set": { "title": "Set", "type": "array", "description": "e.g. `Base Set`.", "items": { "type": "string" } }, "rarity": { "title": "Rarity", "type": "array", "description": "e.g. `Rare`.", "items": { "type": "string" } }, "grade": { "title": "Grade", "type": "array", "description": "e.g. `10`, `9.5`.", "items": { "type": "string" } }, "gradingService": { "title": "Grading service", "type": "array", "description": "e.g. `PSA`, `CGC`, `BECKETT`, `TAG`, `SGC`.", "items": { "type": "string" } }, "cardNumber": { "title": "Card number", "type": "array", "description": "Card number(s).", "items": { "type": "string" } }, "year": { "title": "Year", "type": "array", "description": "Year(s) for sports cards, e.g. 2023 or 1997. Pokémon cards have no Year attribute, so this filter returns no results for them.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }