{ "openapi": "3.0.1", "info": { "title": "Costco US Licensed Feed Qualification", "description": "Search Costco US products, resolve the nearest warehouses from a ZIP code, and collect public online prices, local warehouse prices, stock signals, brands, sizes, categories, images, ratings, and product mappings. Use it for regional price comparison, assortment research, product matching.", "version": "1.5", "x-build-id": "mUKSjpxI5g9yDr5If" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dromb~costco-us/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dromb-costco-us", "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/dromb~costco-us/runs": { "post": { "operationId": "runs-sync-dromb-costco-us", "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/dromb~costco-us/run-sync": { "post": { "operationId": "run-sync-dromb-costco-us", "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": [ "operation" ], "properties": { "operation": { "title": "Operation", "enum": [ "search", "item", "batch", "warehouses" ], "type": "string", "description": "Choose a consumer workflow. Search returns product cards; item returns the richest exact card; batch performs bounded lookups; warehouses finds nearby Costco locations by ZIP code.", "default": "search" }, "query": { "title": "Search query", "type": "string", "description": "Required for search. Use the same words a shopper would enter on the retailer website." }, "productId": { "title": "Product ID", "type": "string", "description": "Required for item unless url is provided. Use the retailer product identifier returned as id." }, "url": { "title": "Product URL", "type": "string", "description": "Optional item input. A public product URL alternative to productId." }, "productIds": { "title": "Product IDs or URLs", "maxItems": 50, "type": "array", "description": "Required for batch. Up to 50 exact IDs or public URLs returned by search.", "items": { "type": "string" } }, "limit": { "title": "Maximum results", "minimum": 1, "maximum": 100, "type": "integer", "description": "Optional explicit cap for customer-visible dataset rows. If omitted, the complete selected native source page or response is preserved; item naturally returns at most one row." }, "postalCode": { "title": "Postal code", "type": "string", "description": "Public Costco ship-to postal context.", "default": "95050" }, "autoResolveLocation": { "title": "Resolve nearest warehouse automatically", "type": "boolean", "description": "Recommended. Resolves the nearest Costco warehouse and state from postalCode for store-aware price and availability.", "default": true }, "shipToState": { "title": "Ship-to state", "type": "string", "description": "Advanced override. Two-letter US state code; normally resolved automatically from postalCode." }, "warehouseId": { "title": "Search warehouse ID", "type": "string", "description": "Advanced override for the public GDX warehouse context. Leave empty to resolve the nearest warehouse from postalCode." }, "productWarehouseNumber": { "title": "Product warehouse number", "type": "string", "description": "Public product GraphQL warehouse context.", "default": "847" }, "deliveryLocationIds": { "title": "GDX delivery location IDs", "maxItems": 12, "type": "array", "description": "Advanced override. Leave empty for automatic postal-to-warehouse resolution. When provided, these IDs and the manual warehouse/state context are used as-is.", "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 } } }, "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 } } } } } } } } } }