# BlockLabs Catalog Taxonomy Browser

> BlockLabs Catalog Taxonomy Browser 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 child taxonomy nodes of the BlockLabs dropshipping catalog category tree, including subtree product counts and live in-stock counts, to help navigate to sellable inventory.

## Facts

- Endpoint: GET https://shop.blocklabs.nl/api/taxonomies
- 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-taxonomy-browser-d511c8c8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-YWHFyeiqE0BzYsJsJcSr

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-taxonomy-browser-d511c8c8
```

Example prompt: Show me the top-level product categories in the BlockLabs dropshipping catalog in English, and tell me which ones have items in stock.

## When to prefer this

Use this endpoint when you need to navigate or enumerate the BlockLabs dropshipping catalog category hierarchy — especially when you want to discover which product branches have live inventory before drilling deeper or running product searches. Prefer this over the product search endpoint when the user wants to explore categories rather than find specific products.

## Known failure modes

- Invalid parent node id (non-numeric or nonexistent) returns an error or empty result
- Invalid iso language code (not two letters) fails schema validation
- Payer wallet not deployed (counterfactual smart account) causes payment rejection and the call cannot proceed
- Network or upstream catalog service unavailable returns a server error
- Requesting a language not supported by the catalog may return untranslated or empty category names

## How this service works

Browse the category tree: children of a taxonomy node (roots when parent is omitted), each with subtree product counts and live in-stock counts - walk the tree to find branches with sellable inventory. Payer wallet must be deployed (counterfactual smart accounts are not supported).

## Output

An array of taxonomy node objects, each representing a child category under the requested parent (or root categories if no parent is specified). Each node includes the category name in the requested language, the node id, total products in its subtree, and live in-stock product counts — enabling the agent to identify which branches contain sellable inventory.

## 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",
     "properties": {
      "iso": {
       "type": "string",
       "default": "en",
       "pattern": "^[a-zA-Z]{2}$",
       "description": "Two-letter language code for category names"
      },
      "parent": {
       "type": "string",
       "pattern": "^\\d+$",
       "description": "Taxonomy node id to list the children of; omit for the root categories"
      }
     }
    }
   },
   "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-taxonomy-browser-d511c8c8/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)