REST API

A REST API for Zenode's component intelligence — part matching, catalog search, live pricing, and AI-driven discovery and deep-dive research.

Capabilities on the near-term roadmap for the Zenode API — alternative-part discovery and job-completion webhooks.

Authenticate and resolve a part number to a canonical Zenode part in one request.

How parts, manufacturers, and categories are identified — readable, stable slugs you can store and reuse.

You pay for detailed part data and AI — the full part record and AI jobs. Matching, catalog search, and metadata are free.

A single error envelope with a typed reason, an HTTP status, and a request_id for support.

Base URL, versioning, request and response format, methods, and how result lists are bounded.

Resolve partial or messy part numbers to canonical Zenode parts — one at a time, or a whole BOM in a single request.

Search the catalog by query and parametric filters, returning compact part summaries (free) — plus a facets endpoint for building filter UIs.

Fetch the full record for one part — specs, pricing, datasheets, and regulatory data — by its manufacturer and MPN slug.

Resolve a manufacturer name to a canonical slug, and fetch a full manufacturer record by slug.

Resolve a category name to a canonical path slug, browse the category tree, and fetch a category by slug.

Describe what you need in plain language; Zenode's AI returns the best parts to choose from, each with a rationale.

Ask Zenode's AI one or more questions about a specific part and get formatted, cited answers.

AI endpoints run as asynchronous jobs — create one, then poll or stream the same job for both progress and the final result.

Read your current billing-period consumption across the metering classes — part records and AI tokens.

The compact part shape returned by the match endpoints.

The full part record — a superset of PartSummary with specs, packaging, pricing, datasheets, lifecycle, and regulatory data.

The shared filter object used by catalog search and its facets.

A single parametric specification on a part.

Physical package and supplier packaging for a part — package type, pin count, and supplier pack quantities.

A distributor's current offer for a part, with its quantity-break price ladder.

A datasheet for a part, linking to the Zenode-hosted document page.

Regulatory, compliance, and trade-classification attributes for a part.

A part's lifecycle status, as a stable lowercase string.

Lifecycle and obsolescence detail for a part — status date and comments, EOL estimates, last-time-buy, and risk ratings.

The manufacturer objects — the lightweight ManufacturerRef embedded in parts, and the fuller Manufacturer record.

The category objects — the CategoryRef embedded in parts, the CategoryNode used to browse the tree, and the fuller Category detail record.

The asynchronous job object that AI endpoints create, plus its compact JobSummary list form.

One deep-dive deliverable's result — a formatted value with an explanation and citations.

A cited source backing an AI answer, linking to the Zenode page that shows it.

Controls the shape of a deep-dive answer — text, number, enum, list, or JSON.

One AI-discovery result — a part plus the rationale for why it fits.

The result payload of a completed discovery job — an overall summary plus the ranked picks.

The result payload of a completed deep-dive job — one answer per requested deliverable.