Reference

Registry Registration

Edit this page

Registry Registration

Register your Commerce 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

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

Step 2: Submit Registration

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 "description": "Premium beauty products",
9 "logo_url": "https://yourstore.com/logo.png",
10 "categories": ["beauty", "cosmetics"]
11 }'

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": false,
7 "status": "pending",
8 "created_at": "2024-01-15T10:00:00Z"
9}

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)