{ "openapi": "3.0.1", "info": { "title": "BJ's Wholesale Scraper: Club Prices, Coupons & Stock", "description": "Get BJ's Wholesale Club products with live member prices by club, Instant Savings dates, coupon conditions, item numbers, sizes and stock. Search, categories or product links by ZIP or club ID. About $0.004 per product: 1,000 products cost $4. No login.", "version": "1.0", "x-build-id": "epuNM14WEGmnL1dmr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/moggedhq~bjs-wholesale-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-moggedhq-bjs-wholesale-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/moggedhq~bjs-wholesale-scraper/runs": { "post": { "operationId": "runs-sync-moggedhq-bjs-wholesale-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/moggedhq~bjs-wholesale-scraper/run-sync": { "post": { "operationId": "run-sync-moggedhq-bjs-wholesale-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Find BJ's products such as milk, coffee or dog food at each club. Leave empty when using product IDs or URLs.", "items": { "type": "string" } }, "startUrls": { "title": "Category, deals or product URLs", "type": "array", "description": "Optional HTTPS BJ's category, product, coupon, deals or search URLs. Run club selections control the price.", "items": { "type": "string" } }, "productIds": { "title": "Product IDs", "type": "array", "description": "BJ's numeric item numbers such as 906 or 297623, or long catalog product IDs such as 3000000000000221387.", "items": { "type": "string" } }, "locations": { "title": "ZIP codes", "type": "array", "description": "US ZIP codes. Chooses the nearest active retail club within 150 miles of the 2025 Census ZIP centroid by straight-line distance. Empty uses the website default club.", "items": { "type": "string" } }, "storeIds": { "title": "Store IDs", "type": "array", "description": "Exact BJ's club numbers, such as 0096 (Willoughby) or 0211 (Northborough). These take precedence over ZIP codes.", "items": { "type": "string" } }, "maxItemsPerSearch": { "title": "Maximum products per search and store", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum new product rows from each term, category or deals source at one store. Duplicates are free.", "default": 20 }, "maxItems": { "title": "Maximum products in this run", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Global limit across all products and stores. About $0.004 per product: 20 products cost about $0.08 plus the small start charge.", "default": 20 }, "dealsOnly": { "title": "Deals only", "type": "boolean", "description": "Keep active Instant Savings and non-geographic guest coupons matched to item numbers. Coupons are not subtracted from the item price.", "default": false }, "includeDetails": { "title": "Include product details", "type": "boolean", "description": "Include the additional description, attributes, badges and catalog availability date supplied in the same public feed. Missing ingredients, barcodes and specifications stay null. No extra charge.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Default: US datacenter, with fresh US residential retries only after datacenter fails. Uses a browser-compatible HTTP transport. Custom proxy settings are supported.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }