Integration Guide

Sign up at /signup to receive your publishable key (pk_live_) and secret key (sk_live_). The publishable key is safe for browser use. The secret key is for server-to-server requests only.

Send your product catalog via POST /v1/catalog/upsert with your secret key. Required fields: id, sku, name, category, price, available, product_url. You can also upload a CSV via POST /v1/catalog/upload.

curl -X POST https://api.regor.ai/v1/catalog/upsert \
  -H "X-API-Key: YOUR_SK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "products": [{
      "id": "SKU-001",
      "sku": "SKU-001",
      "name": "Example Product",
      "category": "Category",
      "price": 29.99,
      "available": true,
      "product_url": "https://yourstore.com/products/example"
    }]
  }'

Add the Regor snippet before </body>. Set data-mode="collect" to shadow your existing search, or "replace" to let Regor serve results directly.

<script
  src="https://api.regor.ai/static/regor.js"
  data-key="YOUR_PK_KEY"
  data-mode="collect"
></script>

Open your site, perform a search, and check the Network tab for POST requests to /v1/events. Within 15 minutes of events flowing, AI agents begin analyzing your search quality.