Today we're releasing Nohi API v1 — our RESTful API for building integrations with the Nohi marketplace. Whether you're a seller automating your product catalog, a developer building an AI shopping assistant, or a platform looking to embed commerce into your product, the API gives you everything you need.
What you can do with the API
The Nohi API covers three core capabilities:
Product Management. Create, update, and manage product listings programmatically. Every field in our product schema is accessible through the API, including specifications, pricing tiers, inventory levels, and fulfillment details. Bulk operations are supported for managing large catalogs.
Transaction Processing. Initiate checkout flows, process payments, and manage orders through a single, consistent interface. Our hosted checkout handles PCI compliance, fraud detection, and payment method management — you just pass us a session token and a product ID.
Webhooks and Events. Subscribe to real-time events for order updates, inventory changes, and agent interactions. Webhooks are delivered with cryptographic signatures and automatic retries, so you never miss a critical event.
Authentication and security
API access uses a two-layer authentication model:
- API keys for server-to-server communication. These are long-lived credentials stored securely on your backend. They have full access to your seller account and should never be exposed to client-side code.
- Session tokens for client-side interactions. Your backend mints short-lived session tokens scoped to a single conversation or user session. These tokens have limited permissions — they can browse products and initiate checkouts, but can't modify listings or access account settings.
This model ensures that even if a session token is intercepted, the blast radius is contained to a single user session with read-mostly permissions.
SDKs and quickstart
We're launching with SDKs for three platforms:
- JavaScript / TypeScript — Works in Node.js, Deno, and edge runtimes. Published to npm as `@nohi/sdk`.
- Python — Supports Python 3.9+ with full type hints. Available on PyPI as `nohi`.
- Go — Idiomatic Go client with context support and structured errors. Install via `go get github.com/nohi-dev/sdk-go`.
Each SDK includes a quickstart example that gets you from zero to your first API call in under five minutes. We've also published OpenAPI specifications for teams that prefer to generate their own clients.
Rate limits and pricing
The API is free to use during our launch period with generous rate limits:
- 1,000 requests per minute for product management endpoints
- 5,000 requests per minute for read-only product discovery
- 100 concurrent checkout sessions per seller
For high-volume sellers, we offer dedicated rate limits and priority support through our Growth plan. Contact us at developers@nohi.dev for details.
What's coming in v1.1
We're already working on the next iteration of the API, which will include:
- Batch checkout — Process multiple items in a single transaction
- Analytics API — Access your sales and agent interaction data programmatically
- Catalog sync — Bi-directional sync with Shopify, WooCommerce, and BigCommerce
- Agent SDK — A specialized SDK for building AI agents that shop on Nohi
We're building this API in close collaboration with our developer community. If you have feature requests or feedback, join our Discord or open an issue on our GitHub repository.
Happy building.
