Skip to main content

Documentation Index

Fetch the complete documentation index at: https://www.octogen.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Octogen is an AI commerce platform that gives Catalog Partner organizations programmatic access to curated product catalogs. Once a catalog is granted to your organization, you can search products by keyword or facets, resolve any product page URL to a full canonical product record, and build commerce workflows into your backend services or AI agents — all through a single API surface.

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:
SurfaceBest forAuth
REST APIBackend services, batch jobs, server-to-serverBearer API key (octo_live_...)
MCP serverInteractive AI agents (Claude Code, Codex, Claude Desktop)OAuth 2.1 + PKCE
Both surfaces enforce the same per-organization catalog grants. A grant change takes effect immediately on all access paths.

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.