SDKs and clients

The API is plain HTTP and JSON — you never need an SDK. The clients exist to save you retry logic, pagination plumbing and webhook signature verification.

TypeScript

Terminal

npm i @commercecensus/node

import { Commerce Census } from "@commercecensus/node";
const pw = new Commerce Census({ key: process.env.CENSUS_KEY });

const ctx = await pw.products.context("0885909950805", { days: 90 });
if (ctx.verdict === "excellent") { /* … */ }

// pagination is an async iterator
for await (const p of pw.search.iterate({ q: "espresso machine" })) { … }

Python

Terminal

pip install commercecensus

from commercecensus import Commerce Census
pw = Commerce Census(key=os.environ["CENSUS_KEY"])

ctx = pw.products.context("0885909950805", days=90)
for p in pw.search.iterate(q="espresso machine"):
    ...

MCP

For agent runtimes, the MCP server exposes six tools with declared meters. It is the same API with a different contract.

JSON

{ "mcpServers": { "census": {
    "command": "npx", "args": ["-y", "@commercecensus/mcp"],
    "env": { "CENSUS_KEY": "cc_live_…" } } } }