Skip to main content

​
Registry Registration

Register your AI Gateway in the Commerce Registry to enable @shop discovery across AI assistants.

​
Why Register?

  • 🔍 Discoverability: Users can find your products via @shop Your Brand
  • ✅ Verification: Build trust with verified brand status
  • 📊 Analytics: Track discovery and usage metrics
  • 🔗 Universal Access: Works with all major AI assistants

​
Registration Process

​
Step 1: Prepare Gateway Information

{
  "brand_name": "Your Brand Name",
  "domain": "yourstore.com",
  "endpoint": "https://gateway.betterdata.co/v1/your-gateway-id",
  "description": "Brief description of your brand",
  "logo_url": "https://yourstore.com/logo.png",
  "categories": ["fashion", "beauty"],
  "verified": false
}

​
Step 2: Submit Registration

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",
    "description": "Premium beauty products",
    "logo_url": "https://yourstore.com/logo.png",
    "categories": ["beauty", "cosmetics"]
  }'
Response: 
{
  "id": "gw_123",
  "brand_name": "Your Brand",
  "domain": "yourstore.com",
  "endpoint": "https://gateway.betterdata.co/v1/your-gateway-id",
  "verified": false,
  "status": "pending",
  "created_at": "2024-01-15T10:00:00Z"
}

​
Step 3: Verification (Optional)

To get verified status:
  1. Verify domain ownership (DNS TXT record)
  2. Complete brand verification process
  3. Wait for manual review (1-2 business days)

​
Discovery Queries

Once registered, users can discover your products via:
  • @shop Your Brand - Browse your catalog
  • @shop Your Brand lipstick - Search your products
  • @shop 012345678901 - Lookup by GTIN/UPC (if configured)