# Octogen

## Docs

- [GET /catalogs — list granted catalogs](https://www.octogen.ai/docs/api-reference/list-catalogs.md): Returns the array of active catalogs your organization has been granted access to, including product counts and last-indexed timestamps.
- [POST /products/lookup — resolve a product URL](https://www.octogen.ai/docs/api-reference/lookup-product.md): POST /products/lookup resolves any product page URL to a full canonical product record, including pricing, images, sizes, variants, and enrichment.
- [MerchantCatalogSummary data model](https://www.octogen.ai/docs/api-reference/models/catalog.md): The catalog object returned by GET /catalogs, containing the key, display name, product count, and indexing metadata for a granted catalog.
- [Product data models: search items and full views](https://www.octogen.ai/docs/api-reference/models/product.md): Reference for MerchantProductListItem returned by search and MerchantProductView returned by lookup, including all fields and example JSON.
- [Platform Catalog API v1 overview](https://www.octogen.ai/docs/api-reference/overview.md): REST API reference for the Octogen Platform Catalog API v1 — base URL, authentication, all three endpoints, error codes, and OpenAPI spec link.
- [POST /products/search — search catalog products](https://www.octogen.ai/docs/api-reference/search-products.md): Searches products within a single granted catalog using free-text queries, structured facet filters, price ranges, and cursor-based pagination.
- [Authenticate with the Octogen Platform API](https://www.octogen.ai/docs/authentication.md): Learn how to create a Platform API key, configure OCTO_API_KEY in your environment, and send it as a Bearer token on every request.
- [Changelog](https://www.octogen.ai/docs/changelog/overview.md): New features, improvements, and fixes for the Octogen Platform.
- [Search products across Octogen catalogs](https://www.octogen.ai/docs/guides/catalog-search.md): Learn how to search products by keyword, filter by facets like color and category, and apply price ranges using the Octogen Catalog API.
- [Handle Octogen API errors in your integration](https://www.octogen.ai/docs/guides/error-handling.md): Understand the Octogen error model, SDK exception types, and recovery strategies for auth failures, missing resources, and validation errors.
- [Paginate through large Octogen search results](https://www.octogen.ai/docs/guides/pagination.md): Use cursor-based pagination to iterate through all matching products in an Octogen catalog search, page by page, without missing or duplicating results.
- [Look up a product by URL in Octogen](https://www.octogen.ai/docs/guides/product-lookup.md): Resolve any product page URL to a full canonical enriched product record, including variants, sizes, colors, and Octogen enrichment data.
- [What is Octogen? AI commerce for Catalog Partners](https://www.octogen.ai/docs/introduction.md): Octogen gives Catalog Partners programmatic access to curated product catalogs — search products, look up items by URL, and power AI agent integrations.
- [Use Octogen with Claude Code via MCP](https://www.octogen.ai/docs/mcp/claude-code.md): Register the Octogen MCP server in Claude Code with one command, then let your agent search and look up products from any granted catalog.
- [Use Octogen with Claude Desktop via MCP](https://www.octogen.ai/docs/mcp/claude-desktop.md): Bridge Claude Desktop to the Octogen MCP server using the mcp-remote adapter — edit one config file, restart the app, and sign in once.
- [Use Octogen with Codex CLI via MCP](https://www.octogen.ai/docs/mcp/codex-cli.md): Connect Codex CLI to Octogen using its dedicated compatibility endpoint, then sign in once to give your agent access to your granted catalogs.
- [Connect AI agents to Octogen via MCP](https://www.octogen.ai/docs/mcp/overview.md): Let AI coding tools search and look up products in your granted Octogen catalogs using the Model Context Protocol — no API keys required.
- [Get started with Octogen in minutes](https://www.octogen.ai/docs/quickstart.md): Go from zero to your first product search result: set up your API key, list your catalogs, search products, and look up a product by URL.
- [Octogen Python SDK — async HTTP client API reference](https://www.octogen.ai/docs/sdks/python.md): Install the async Python SDK for Octogen, set your API key, and search or look up products from your granted catalogs with typed Pydantic models.
- [Octogen TypeScript SDK — async client API reference](https://www.octogen.ai/docs/sdks/typescript.md): Install the TypeScript SDK for Octogen, set your API key, and search or look up products from your granted catalogs with full ESM type safety in Node.js.