Hosted

Hosted Gateway & Registry - Getting Started

Edit this page

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 IntegrationsAI Gateway
  3. Click Create Gateway
  4. Select your commerce platform:
    • Shopify
    • BigCommerce
    • WooCommerce
    • Custom (REST API)

Step 2: Configure Connector

Shopify

1{
2 "platform": "shopify",
3 "storeUrl": "your-store.myshopify.com",
4 "storefrontAccessToken": "your-storefront-token",
5 "apiVersion": "2024-01"
6}

BigCommerce

1{
2 "platform": "bigcommerce",
3 "storeHash": "your-store-hash",
4 "accessToken": "your-access-token"
5}

WooCommerce

1{
2 "platform": "woocommerce",
3 "storeUrl": "https://yourstore.com",
4 "consumerKey": "your-consumer-key",
5 "consumerSecret": "your-consumer-secret"
6}

Step 3: Register in Commerce Registry

Once your gateway is configured, register it in the Commerce Registry to enable @shop discovery:

1curl -X POST https://registry.betterdata.co/api/gateways \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "brand_name": "Your Brand",
6 "domain": "yourstore.com",
7 "endpoint": "https://gateway.betterdata.co/v1/your-gateway-id",
8 "verified": true
9 }'

Response:

1{
2 "id": "gw_123",
3 "brand_name": "Your Brand",
4 "domain": "yourstore.com",
5 "endpoint": "https://gateway.betterdata.co/v1/your-gateway-id",
6 "verified": true,
7 "created_at": "2024-01-15T10:00:00Z"
8}

Step 4: Test Your Gateway

Test with Claude (MCP)

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

Test with OpenAI (Functions)

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

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.