# Costco Product Details

> Costco Product Details 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).

Retrieves full details of a specific Costco product by its item ID, including pricing, images, ratings, availability, and description.

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-costco-data/product-details?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-product-details-1c60c22b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_q5mJcBTeT_JOiFKyJaX_f

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-product-details-1c60c22b
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Get the full details of a specific Costco product by its item id.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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": "
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-costco-product-details-1c60c22b/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)