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 gives Catalog Partners programmatic access to curated product catalogs — enabling product search, URL-based product lookup, and seamless AI agent integrations. Whether you’re building a backend service, a shopping assistant, or integrating with Claude or Codex, Octogen provides the tools you need.

Quick Start

Make your first API call in minutes. List catalogs, search products, and look up items by URL.

Authentication

Get your API key and learn how to authenticate every request to the Octogen platform.

Python SDK

Install the async Python SDK and start querying 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 Claude Code, Codex CLI, or Claude Desktop to Octogen catalogs via MCP.

API Reference

Full reference for the Platform Catalog API v1 — endpoints, parameters, and response schemas.

​
How it works

1

Get access

Contact Octogen to provision your organization as a Catalog Partner and have catalogs granted to your account.
2

Authenticate

Create a Platform API key from the partner portal. Set it as OCTO_API_KEY in your environment or pass it directly to the SDK client.
3

List your catalogs

Call GET /v1/catalogs (or client.list_catalogs()) to see which product catalogs your key can access.
4

Search and look up products

Use POST /v1/products/search to find products by keyword or facet, or POST /v1/products/lookup to resolve a product page URL to its full canonical record.
Both the REST API and MCP server enforce the same per-organization catalog grants. A catalog grant revoked in the partner portal takes effect immediately on all access paths.