{"uid":"cap_8eC64CgFokSExmOctoGWn","slug":"agents-openwebninja-com-costco-real-time-product-search-4e4af325","name":"Costco Real-Time Product Search","description":"Search","url":"https://agents.openwebninja.com/realtime-costco-data/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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."}}},"responseSchema":{"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 facet"},"display_order":{"type":"integer","description":"The order in which the facet is displayed"}}},"item_location_pricing_salePrice":{"type":"object","properties":{"label":{"type":"string","description":"Display label for the price facet"},"facetKey":{"type":"string","description":"Key identifying the price 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"}}}}},"total_products":{"type":"integer","description":"The total number of products matching the query"},"delivery_location_applied":{"type":"boolean","description":"Whether the requested delivery_location was applied to the query. Only present when delivery_location was supplied. False means the location could not be resolved and unscoped results were returned instead."}}},"status":{"type":"string","description":"The status of the API response"},"parameters":{"type":"object","properties":{"query":{"type":"string","description":"The search query used to fetch products"},"start":{"type":"integer","description":"The offset or index to start retrieving results from"},"country":{"type":"string","description":"The country code for localization"},"language":{"type":"string","description":"The language code for localization"},"delivery_location":{"type":"string","description":"The normalized delivery location the results were scoped to. Only present when delivery_location was supplied."}}},"request_id":{"type":"string","description":"A unique identifier for the API request"}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_tWn4STGpW0TSVUF9_9R-z","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Search Costco's live product catalog by keyword, with optional location-scoped availability and pagination","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Find local Costco grocery availability","prompt":"Search Costco for 'almond milk' and filter results to my ZIP code 10001 in New York so I can see which ones are in stock and available for delivery to me."},{"title":"Compare Costco Canada product options","prompt":"Can you search Costco Canada for 'air purifier' in French (fr-CA) and show me what's available? I'm in Montreal with postal code H3A 1A1."},{"title":"Browse Costco electronics with pagination","prompt":"Search Costco for 'laptop' in the US and skip the first 20 results so I can see the next page of products — I'm near Seattle, ZIP 98101."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:51.037Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-costco-real-time-product-search-4e4af325"}