# Peddlr Marketplace Categories API

> Peddlr Marketplace Categories API is a paid API for AI agents from pudlur.vercel.app, paid per call via x402, $0.2/call, status unknown (last checked 2026-09-13).

Retrieves available product categories from Tokopedia or AliExpress marketplaces for navigation and product discovery

## Facts

- Endpoint: POST https://pudlur.vercel.app/api/categories
- Price: $0.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/peddlr-marketplace-categories-api-eabeeb96
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vQpppUCLt1jEfOgAafsLU

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 peddlr-marketplace-categories-api-eabeeb96 -d '<json body>'
```

Example prompt: Can you pull up all the product categories available on Tokopedia so I can see what departments they carry?

## When to prefer this

Use this endpoint when you need to enumerate or browse the category taxonomy of Tokopedia or AliExpress before performing targeted product searches — ideal for catalog mapping, navigation UI, or scoping a product search to a specific department.

## Known failure modes

- Invalid or unsupported marketplace name returns failure or empty data
- Network timeout from upstream marketplace data source
- Missing marketplace parameter may return error or default result
- Marketplace-specific outages may cause stale or no data

## How this service works

Search, compare, and analyze products across Tokopedia and AliExpress. Real-time marketplace data for AI agents.

## Output

Returns a success flag and a data object containing the list of product categories available on the specified marketplace (Tokopedia or AliExpress), including category names and likely identifiers for further product searches.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "marketplace": {
   "enum": [
    "tokopedia",
    "aliexpress"
   ],
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "success"
 ],
 "properties": {
  "data": {
   "type": "object"
  },
  "success": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/peddlr-marketplace-categories-api-eabeeb96/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pudlur.vercel.app](https://www.zero.xyz/host/pudlur.vercel.app/llms.txt)
