Get started with Octogen in minutes

curl -sS https://api.octogen.ai/v1/products/search \
  -H "Authorization: Bearer $OCTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "q": "women'\''s linen summer dresses",
    "limit": 5
  }'

import asyncio
from octogen_ai_sdk import OctogenAPIError, OctogenClient

async def main():
    try:
        async with OctogenClient() as client:
            results = await client.search_products(
                q="women's linen summer dresses",
                limit=5,
            )

            print("Catalog scope: all active crawled catalogs")
            for product in results.items:
                brand = product.brand.name if product.brand else "Unknown brand"
                price = (
                    f"${product.current_price:.2f}"
                    if product.current_price is not None
                    else "Price unavailable"
                )
                title = product.title or "Untitled product"
                print(f"- {title} | {brand} | {price}")
                print(f"  {product.product_url}")
    except OctogenAPIError as exc:
        print(f"Octogen API error: status={exc.status_code}")
        raise

asyncio.run(main())

import { OctogenAPIError, OctogenClient } from "@octogen-ai/sdk";

try {
  const client = new OctogenClient();
  const results = await client.searchProducts({
    q: "women's linen summer dresses",
    limit: 5,
  });

  console.log("Catalog scope: all active crawled catalogs");
  for (const product of results.items) {
    const brand = product.brand?.name ?? "Unknown brand";
    const price =
      product.currentPrice == null
        ? "Price unavailable"
        : `$${product.currentPrice.toFixed(2)}`;
    console.log(`- ${product.title ?? "Untitled product"} | ${brand} | ${price}`);
    console.log(`  ${product.productUrl}`);
  }
} catch (error) {
  if (error instanceof OctogenAPIError) {
    console.error(`Octogen API error: status=${String(error.statusCode)}`);
  }
  throw error;
}

curl -sS https://api.octogen.ai/v1/products/lookup \
  -H "Authorization: Bearer $OCTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://warrenlotas.com/products/black-hoodie"}'

import asyncio
from octogen_ai_sdk import OctogenClient

async def main():
    async with OctogenClient() as client:
        result = await client.lookup_product(
            "https://warrenlotas.com/products/black-hoodie"
        )
        product = result.product
        print(f"{product.title} — ${product.current_price:.2f}")
        print(f"In stock: {product.in_stock}")
        print(f"Sizes: {product.sizes}")

asyncio.run(main())

import { OctogenClient } from "@octogen-ai/sdk";

const client = new OctogenClient();
const result = await client.lookupProduct(
  "https://warrenlotas.com/products/black-hoodie"
);
const { product } = result;
console.log(`${product.title} — $${product.currentPrice?.toFixed(2)}`);
console.log(`In stock: ${product.inStock}`);
console.log(`Sizes: ${product.sizes?.join(", ")}`);