What you can do
- Search products — query a granted catalog by keyword, filter by color, category, brand, price range, and other facets, and paginate through results.
- Look up products by URL — resolve a product page URL to a structured record with full detail: pricing, sizing, images, variants, and more.
- List your catalogs — discover which catalogs are active and available to your API key at any time.
- Build AI agent workflows — connect Claude Code, Codex CLI, or Claude Desktop directly to your granted catalogs via the Catalog Partner MCP server.
Two ways to access Octogen
You can reach the same product data through two fully supported surfaces. Choose based on your runtime:| Surface | Best for | Auth |
|---|---|---|
| REST API | Backend services, batch jobs, server-to-server | Bearer API key (octo_live_...) |
| MCP server | Interactive AI agents (Claude Code, Codex, Claude Desktop) | OAuth 2.1 + PKCE |
Start here
Authentication
Get your API key and learn how to authenticate every request.
Quickstart
Make your first API call and retrieve real product data in minutes.
Python SDK
Install the async Python SDK and query catalogs with typed Pydantic models.
TypeScript SDK
Use the ESM TypeScript SDK with full type safety in Node.js or edge runtimes.
MCP Integration
Connect AI agents to your granted catalogs via the Catalog Partner MCP server.
API Reference
Full reference for the Platform Catalog API v1 — endpoints, parameters, and schemas.