Skip to main content

​
Hosted Gateway & Registry - Getting Started

Get started with Better Data’s hosted AI Gateway and Commerce Registry in minutes.
Hosted Endpoints:
  • Gateway: https://gateway.betterdata.co
  • Registry: https://registry.betterdata.co

​
Prerequisites

  • A Better Data account (sign up at app.betterdata.co)
  • A commerce platform (Shopify, BigCommerce, WooCommerce, or custom)
  • API credentials for your commerce platform

​
Step 1: Create Gateway Connection

  1. Log in to app.betterdata.co
  2. Navigate to Integrations → AI Gateway
  3. Click Create Gateway
  4. Select your commerce platform:
    • Shopify
    • BigCommerce
    • WooCommerce
    • Custom (REST API)

​
Step 2: Configure Connector

​
Shopify

{
  "platform": "shopify",
  "storeUrl": "your-store.myshopify.com",
  "storefrontAccessToken": "your-storefront-token",
  "apiVersion": "2024-01"
}

​
BigCommerce

{
  "platform": "bigcommerce",
  "storeHash": "your-store-hash",
  "accessToken": "your-access-token"
}

​
WooCommerce

{
  "platform": "woocommerce",
  "storeUrl": "https://yourstore.com",
  "consumerKey": "your-consumer-key",
  "consumerSecret": "your-consumer-secret"
}

​
Step 3: Register in Commerce Registry

Once your gateway is configured, register it in the Commerce Registry to enable @shop discovery: 
curl -X POST https://registry.betterdata.co/api/gateways \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brand_name": "Your Brand",
    "domain": "yourstore.com",
    "endpoint": "https://gateway.betterdata.co/v1/your-gateway-id",
    "verified": true
  }'
Response: 
{
  "id": "gw_123",
  "brand_name": "Your Brand",
  "domain": "yourstore.com",
  "endpoint": "https://gateway.betterdata.co/v1/your-gateway-id",
  "verified": true,
  "created_at": "2024-01-15T10:00:00Z"
}

​
Step 4: Test Your Gateway

​
Test with Claude (MCP)

curl -X POST https://gateway.betterdata.co/v1/your-gateway-id/tools \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "claude",
    "session_id": "test-session-123"
  }'

​
Test with OpenAI (Functions)

curl -X POST https://gateway.betterdata.co/v1/your-gateway-id/tools \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "openai",
    "session_id": "test-session-123"
  }'

​
Step 5: Enable @shop Discovery

Once registered, users can discover your products via:
  • @shop Your Brand - Browse your catalog
  • @shop Your Brand product name - Search your products
  • @shop 012345678901 - Lookup by GTIN/UPC

​
Next Steps

​
Support

Need help? Contact us at support@betterdata.co or visit our documentation.