# BlockLabs Catalog Product Detail

> BlockLabs Catalog Product Detail is a paid API for AI agents from shop.blocklabs.nl, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-13).

Returns full product details (name, description, prices, live stock, images, taxonomy, manufacturer) for a single catalog item by product ID or SKU

## Facts

- Endpoint: GET https://shop.blocklabs.nl/api/product
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blocklabs-catalog-product-detail-d63e0cf3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_b3HLaw8NfYrejslEym7fA

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 blocklabs-catalog-product-detail-d63e0cf3
```

Example prompt: Can you pull up the full product details for SKU 'BL-48291' from the BlockLabs catalog, including current stock, price, images, and category — give me the info in English?

## When to prefer this

Use this endpoint when you have a specific catalog product ID or SKU (e.g. from a prior /api/search call) and need comprehensive product data including live stock, all images, pricing, taxonomy, and manufacturer info in one call. Prefer this over search when you already know the exact product reference. It is the right choice for populating product listing pages, checking real-time inventory before ordering, or enriching dropship catalog data.

## Known failure modes

- Unknown product ID or SKU returns found:false but still incurs a $0.001 charge
- Counterfactual (undeployed) smart account wallets are rejected — payer wallet must be fully deployed
- Missing required 'ref' query parameter results in a request error
- Invalid ISO language code (not exactly 2 letters) fails schema validation
- Payment failure if wallet has insufficient USDC balance

## How this service works

Full product detail by catalog product id or SKU: name, description, prices, live stock, all images, taxonomy, manufacturer. Returns found:false (still charged) for unknown refs. Payer wallet must be deployed (counterfactual smart accounts are not supported).

## Output

A structured product object containing: product name, full description, price(s), real-time stock quantity, all available product images, taxonomy/category path, manufacturer details, and a 'found' boolean. If the product ID or SKU is not recognized, returns found:false (the call is still charged).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "ref"
     ],
     "properties": {
      "iso": {
       "type": "string",
       "default": "en",
       "pattern": "^[a-zA-Z]{2}$",
       "description": "Two-letter language code for name/description/taxonomy"
      },
      "ref": {
       "type": "string",
       "minLength": 1,
       "description": "Catalog product id (numeric) or product SKU (from /api/search)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blocklabs-catalog-product-detail-d63e0cf3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from shop.blocklabs.nl](https://www.zero.xyz/host/shop.blocklabs.nl/llms.txt)
