{"uid":"cap_q5mJcBTeT_JOiFKyJaX_f","slug":"agents-openwebninja-com-costco-product-details-1c60c22b","name":"Costco Product Details","description":"Get the full details of a specific Costco product by its item id.","url":"https://agents.openwebninja.com/realtime-costco-data/product-details?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["product_id"],"properties":{"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."},"product_id":{"type":"string","description":"The Costco product / item id to retrieve details for. You can find product item ids in the `item_number` field returned by the /search endpoint."},"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","required":["item_number","item_name","item_product_name","id"],"properties":{"id":{"type":"string","description":"Internal identifier of the product (item id + locale)."},"name":{"type":"string","nullable":true,"description":"Product name."},"image":{"type":"string","nullable":true,"description":"Primary image URL."},"images":{"type":"array","items":{"type":"object","properties":{"item_collateral_primaryimage":{"type":"string","description":"Image URL."}}},"nullable":true,"description":"Additional images of the product."},"group_id":{"type":"string","nullable":true,"description":"Costco product group identifier (groups variants of the same product)."},"item_name":{"type":"string","description":"Full product name including variant attributes (color, size)."},"Brand_attr":{"type":"array","items":{"type":"string","description":"Brand name."},"nullable":true,"description":"Brand attribute values."},"Color_attr":{"type":"array","items":{"type":"string","description":"Color name."},"nullable":true,"description":"Color attribute values."},"description":{"type":"string","nullable":true,"description":"Long product description."},"item_number":{"type":"string","description":"Costco item number (matches the `product_id` query parameter)."},"content_type":{"type":"array","items":{"type":"string","description":"Content type."},"nullable":true,"description":"Content type tags for the product (typically [\"product\"])."},"hasSingleSku":{"type":"boolean","nullable":true,"description":"Whether the product has a single SKU (no variants)."},"isFutureDate":{"type":"boolean","nullable":true,"description":"Whether the product start date is in the future."},"item_buyable":{"type":"boolean","nullable":true,"description":"Whether the product is currently buyable."},"item_ratings":{"type":"number","nullable":true,"description":"Average customer rating (numeric)."},"maxSalePrice":{"type":"number","nullable":true,"description":"Maximum sale price across variants."},"minSalePrice":{"type":"number","nullable":true,"description":"Minimum sale price across variants."},"isItemInStock":{"type":"boolean","nullable":true,"description":"Whether the item is currently in stock."},"deliveryStatus":{"type":"string","nullable":true,"description":"Delivery status label for the product."},"item_startDate":{"type":"string","nullable":true,"description":"ISO 8601 datetime the product was first listed."},"categoryPath_ss":{"type":"array","items":{"type":"string","description":"Category path."},"nullable":true,"description":"Category breadcrumb paths the product belongs to."},"item_comparable":{"type":"boolean","nullable":true,"description":"Whether the product is included in comparison tools."},"item_searchable":{"type":"boolean","nullable":true,"description":"Whether the product is searchable."},"Online_Only_attr":{"type":"array","items":{"type":"string","description":"Label."},"nullable":true,"description":"Online-only attribute labels."},"item_member_only":{"type":"boolean","nullable":true,"description":"Whether the product is restricted to Costco members."},"Women_s_Size_attr":{"type":"array","items":{"type":"string","description":"Size."},"nullable":true,"description":"Women's size attribute values, when applicable."},"item_fsa_eligible":{"type":"boolean","nullable":true,"description":"Whether the product is FSA-eligible."},"item_product_name":{"type":"string","description":"Product name without variant attributes."},"item_rating_value":{"type":"array","items":{"type":"string","description":"Rating bucket label."},"nullable":true,"description":"Rating-bucket facet labels the product belongs to."},"item_review_count":{"type":"integer","nullable":true,"description":"Number of customer reviews considered for `item_ratings`."},"item_chdi_eligible":{"type":"boolean","nullable":true,"description":"Whether the product is CHDI-eligible."},"item_disponzeroinv":{"type":"boolean","nullable":true,"description":"Whether the variant is displayed when out of stock."},"item_as400_category":{"type":"string","nullable":true,"description":"AS400 category code."},"item_review_ratings":{"type":"string","nullable":true,"description":"Average customer rating as a string."},"item_variableweight":{"type":"boolean","nullable":true,"description":"Whether the product has variable weight."},"item_pill_attributes":{"type":"array","items":{"type":"string","description":"Pill attribute entry."},"nullable":true,"description":"Pill / badge attributes shown on the product card (raw key|label pairs)."},"item_product_buyable":{"type":"boolean","nullable":true,"description":"Whether the product (any variant) is buyable."},"Online_Only_attr_pill":{"type":"array","items":{"type":"string","description":"Pill label."},"nullable":true,"description":"Online-only pill labels."},"item_as400_department":{"type":"string","nullable":true,"description":"AS400 department code."},"item_image_swatchable":{"type":"boolean","nullable":true,"description":"Whether the variant image supports color swatch switching."},"item_status_published":{"type":"boolean","nullable":true,"description":"Whether the variant is published."},"item_link_fee_eligible":{"type":"string","nullable":true,"description":"Whether the product is link-fee eligible. Values: 'true', 'false'."},"item_short_description":{"type":"string","nullable":true,"description":"Short product description including variant attributes."},"deliverable_to_location":{"type":"boolean","description":"Whether this product is available for delivery to the requested delivery_location. Only present when delivery_location was supplied and resolved. When false, the product exists but is not deliverable there, and the item_location_* fields describe an unscoped fallback lookup."},"item_manufacturing_skus":{"type":"array","items":{"type":"string","description":"SKU."},"nullable":true,"description":"Manufacturer SKUs / barcodes associated with the product."},"item_product_comparable":{"type":"boolean","nullable":true,"description":"Whether the product is comparable at the product level."},"item_eligible_for_review":{"type":"string","nullable":true,"description":"Whether the product is eligible for reviews. Values: 'true', 'false'."},"item_location_itemNumber":{"type":"string","nullable":true,"description":"Item number at the configured location."},"item_program_eligibility":{"type":"array","items":{"type":"string","description":"Program tag."},"nullable":true,"description":"Program eligibility tags (e.g. Standard, ShipIt, Google)."},"delivery_location_applied":{"type":"boolean","description":"Whether the requested delivery_location was applied to the lookup. Only present when delivery_location was supplied."},"item_location_stockStatus":{"type":"string","nullable":true,"description":"Stock status at the configured location."},"item_product_review_count":{"type":"integer","nullable":true,"description":"Number of customer reviews at the product level."},"item_rating_average_value":{"type":"number","nullable":true,"description":"Computed average rating value."},"item_location_availability":{"type":"string","nullable":true,"description":"Availability label at the configured location."},"item_location_currencyCode":{"type":"string","nullable":true,"description":"ISO 4217 currency code of the pricing."},"item_product_primary_image":{"type":"string","nullable":true,"description":"Primary product image URL."},"item_collateral_primaryimage":{"type":"string","nullable":true,"description":"Primary collateral image URL for the variant."},"item_location_locationNumber":{"type":"string","nullable":true,"description":"Identifier of the configured location used for pricing / availability."},"item_product_review_eligible":{"type":"boolean","nullable":true,"description":"Whether the product is eligible for customer reviews."},"item_classification_itemclass":{"type":"string","nullable":true,"description":"Item classification class (e.g. Standard)."},"item_product_image_swatchable":{"type":"boolean","nullable":true,"description":"Whether the product image supports color swatch switching."},"item_product_status_published":{"type":"boolean","nullable":true,"description":"Whether the product is published."},"item_product_short_description":{"type":"string","nullable":true,"description":"Short product description without variant attributes."},"item_location_pricing_listPrice":{"type":"number","nullable":true,"description":"List price for the configured location."},"item_location_pricing_salePrice":{"type":"number","nullable":true,"description":"Current sale price for the configured location."},"item_product_marketing_features":{"type":"array","items":{"type":"string","description":"Feature bullet."},"nullable":true,"description":"Marketing bullet features of the product."},"item_product_price_in_cart_only":{"type":"string","nullable":true,"description":"Whether the final price is only revealed in the cart. Values: '0', '1'."},"item_product_marketing_statement":{"type":"string","nullable":true,"description":"Marketing tagline shown for the product."},"item_product_status_disponzeroinv":{"type":"boolean","nullable":true,"description":"Whether the product is displayed when out of stock at the product level."},"item_product_marketingcontent_keywords":{"type":"array","items":{"type":"string","description":"Keyword."},"nullable":true,"description":"Marketing keywords tagged on the product."},"item_location_pricing_pricePerUnit_price":{"type":"number","nullable":true,"description":"Price per unit for the configured location."}},"description":"The full Costco product object. Same field shape as items inside the /search endpoint's `products` array."},"status":{"type":"string","description":"The status of the API response"},"parameters":{"type":"object","properties":{"country":{"type":"string","description":"The country code for localization"},"language":{"type":"string","description":"The language code for localization"},"product_id":{"type":"string","description":"The product / item id used to fetch the product details"},"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_M03xKKg9045ZiP6Bso3Ty","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":"Retrieves full details of a specific Costco product by its item ID, including pricing, images, ratings, availability, and description.","exampleAgentPrompt":"Can you pull up the full Costco product details for item number 1234567 — I want to see the description, price, images, and whether it's in stock for delivery to ZIP code 98101?","exampleUseCases":[{"title":"Check Costco item availability near me","prompt":"I found a Costco item number 9876543 online — can you check if it's available for delivery to my ZIP code 90210 and tell me the current price and stock status?"},{"title":"Compare Costco product specs before buying","prompt":"Get me the full details on Costco item 1234567 in the US — I need the brand, description, customer rating, and all available images so I can decide if it's worth buying."},{"title":"Fetch Costco Canada product info in French","prompt":"Pull up the details for Costco Canada product item 5551234 with the language set to French (fr-CA) and scoped to postal code M4V 2H7 — I want to see the full name, description, and availability."}],"resultDescription":"Returns a data object containing the Costco product's item number, full name, description, primary and additional images, brand, color, price (list/sale/max/min), average customer rating, buyable status, stock availability, fulfillment location, order quantity limits (min/max), group ID, SKU details, and content type tags. Availability and fulfillment fields are only populated when a delivery location is provided.","failureModes":["Invalid or nonexistent product_id returns empty or error response","Product not available in specified country returns no data","Delivery location outside Costco's service area may return no availability data","Unsupported language code returns an error","Missing required product_id parameter returns a validation error","Truncated response schema may omit some fields at runtime"],"whenToPreferThis":"Use this endpoint when you have a specific Costco item ID and need comprehensive product details including price, images, description, ratings, and location-specific availability. It is ideal after using the Costco Search endpoint to obtain item IDs. Prefer this over the Search endpoint when you already know the exact item number and need deep product data rather than a list of results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:58.477Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-costco-product-details-1c60c22b"}