# Costco Real-Time Product Search > Costco Real-Time Product Search is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14). Search Costco's live product catalog by keyword, with optional location-scoped availability and pagination ## Facts - Endpoint: GET https://agents.openwebninja.com/realtime-costco-data/search?utm_source=zero.xyz - Price: price unknown - Payment: MPP - Status: unknown - Last checked: 2026-10-14 - Activations on Zero: 0 - Provider: agents.openwebninja.com - Website: https://agents.openwebninja.com - Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-costco-real-time-product-search-4e4af325 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8eC64CgFokSExmOctoGWn Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability agents-openwebninja-com-costco-real-time-product-search-4e4af325 ``` Example prompt: Can you search Costco for 'organic olive oil' in the US and scope the results to ZIP code 98101 so I can see what's actually available for delivery to my area? ## When to prefer this Use this endpoint when you need real-time, location-aware Costco product search results — especially when stock availability, fulfillment node, or order quantity limits matter for a specific US ZIP or Canadian postal code. Prefer this over static product databases when you need live Costco catalog data including current filter facets and availability status. ## Known failure modes - Missing required 'query' parameter returns a validation error - Invalid country code (not US or CA) causes a bad request response - Invalid language for the selected country (e.g. fr-CA with country=US) causes an error - Invalid ZIP or postal code format for delivery_location may return unscoped or empty results - Query returns zero results for niche or misspelled search terms - Service may be rate-limited or return errors during high traffic periods ## How this service works Search ## Output Returns a structured object containing product listings matching the query along with filter facets (category, rating, program eligibility, availability, price range) and location-specific data such as stock status, fulfillment node, and order quantity limits when a delivery_location is provided. ## Request schema (JSON Schema) ```json { "type": "object", "required": [ "query" ], "properties": { "query": { "type": "string", "description": "Search query." }, "start": { "type": "number", "default": 0, "description": "Number of results to skip (offset)." }, "country": { "type": "string", "default": "US", "description": "The Costco country / domain to use. US or CA." }, "language": { "type": "string", "default": "en-US", "description": "The language to use for the results. Defaults to the first / major language in the specified country - en-US for country=US and en-CA for country=CA.\n Allowed values: en-US for US / en-CA or fr-CA for CA." }, "delivery_location": { "type": "string", "description": "Delivery location to scope results to, as a ZIP code for country=US (e.g. 98101) or a postal code for country=CA (e.g. M4V 2H7).\n Costco's catalog is fulfilled from location-specific distribution, grocery and pickup centers, so this affects which products are available, which node fulfills them (item_location_locationNumber), their stock status (item_location_availability) and the order quantity limits (item_location_fulfillment_restrictions_minQty / maxQty).\n Note that Costco list prices are national, so this does not change prices.\n When omitted, results are not scoped to any location." } } } ``` ## Response schema (JSON Schema) ```json { "type": "object", "properties": { "data": { "type": "object", "properties": { "filters": { "type": "object", "properties": { "item_category": { "type": "object", "properties": { "label": { "type": "string", "description": "Display label for the category facet" }, "facetKey": { "type": "string", "description": "Key identifying the category facet" }, "multiselect": { "type": "boolean", "description": "Indicates if multiple selections are allowed for this facet" }, "display_order": { "type": "integer", "description": "The order in which the facet is displayed" } } }, "item_rating_value": { "type": "object", "properties": { "label": { "type": "string", "description": "Display label for the rating facet" }, "facetKey": { "type": "string", "description": "Key identifying the rating facet" }, "multiselect": { "type": "boolean", "description": "Indicates if multiple selections are allowed for this facet" }, "display_order": { "type": "integer", "description": "The order in which the facet is displayed" } } }, "item_program_eligibility": { "type": "object", "properties": { "label": { "type": "string", "description": "Display label for the program eligibility facet" }, "facetKey": { "type": "string", "description": "Key identifying the program eligibility facet" }, "multiselect": { "type": "boolean", "description": "Indicates if multiple selections are allowed for this facet" }, "display_order": { "type": "integer", "description": "The order in which the facet is displayed" } } }, "item_location_availability": { "type": "object", "properties": { "label": { "type": "string", "description": "Display label for the availability facet" }, "facetKey": { "type": "string", "description": "Key identifying the availability facet" }, "multiselect": { "type": "boolean", "description": "Indicates if multiple selections are allowed for this face … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-costco-real-time-product-search-4e4af325/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)