ZooData Skills

---
name: zoodata
description: >
  API endpoint reference for ZooData's Amazon commerce and keyword-intelligence
  surfaces, including request/response schemas, parameter quirks, authentication,
  credit metadata, product-traffic structure and trend APIs, and the Local Review
  Toolkit.
  Use when the user asks about the API itself: which endpoints exist, how
  to call them (e.g. /products/search), field schemas returned by an
  endpoint, parameter quirks, how to authenticate, how credit consumption
  is reported, how to get started, or how the Local Review Toolkit works.
  Requires ZOODATA_API_KEY.
metadata:
  version: "1.3.0"
  author: SerendipityOneInc
  homepage: https://github.com/SerendipityOneInc/ZooData-Skills
  openclaw: {"requires": {"env": ["ZOODATA_API_KEY"]}, "primaryEnv": "ZOODATA_API_KEY"}
---

> **📋 Live API Reference**: Field names and parameters may change. For MCP calls, refresh and
> inspect the current ZooData MCP `inputSchema` and `outputSchema`; for direct HTTP calls, also consult the OpenAPI
> spec at https://zoodata.ai/api/v1/openapi-spec.
> Keyword compatibility field: all eleven current keyword and product-traffic request schemas
> retain `granularity`, but the only supported value is `week`. The bundled CLI always sends
> `granularity=week`. Never send `day`, `month`, `lately_day`, or legacy `lookbackDays`; use the
> weekly period boundaries returned by the service.

# ZooData — Commerce Data Infrastructure for AI Agents

200M+ Amazon products. 36 Amazon and keyword-intelligence endpoints. One API key.

## Quick Start
1. Get key: [zoodata.ai/api-keys](https://zoodata.ai/en/api-keys) (1,000 free credits)
2. `export ZOODATA_API_KEY='hms_live_xxx'`
3. Base URL: `https://api.zoodata.ai/openapi/v2` — all POST with JSON body
4. Auth: `Authorization: Bearer YOUR_API_KEY`
5. New keys need 3-5s to activate. If 403, wait and retry.

## Capabilities & Data Flow

- **Network**: only `https://api.zoodata.ai` (Bearer `ZOODATA_API_KEY`). Setting `ZOODATA_BASE_URL` to an untrusted host (anything other than `api.zoodata.ai` / `*.zoodata.ai` / localhost) makes the CLI **refuse the request and withhold the key** — the Bearer token is never sent to an untrusted host.
- **Execution**: bundled shared ZooData CLI `{skill_base_dir}/scripts/zoodata.py` (Python 3, stdlib-only). This data-layer reference skill allows the complete literal subcommand surface exposed by the bundled client's current top-level help.
- **Local files**: none by default; reads the optional credential store `~/.zoodata/config.json`; the Local Review Toolkit uses a private temporary working dir (created with `mktemp -d`, removed when the fallback completes) during the review fallback.
- **Sent to the API**: keywords, category paths, ASINs, marketplace/date and numeric filter values only. **Never sent**: budget, experience level, risk tolerance, or any other user-profile text — profile inputs map client-side to numeric filters.
- **Credits**: every API call consumes account credits. For broad or ambiguous requests, state the estimated credit cost and confirm with the user before running multi-call scans.