> ## Documentation Index
> Fetch the complete documentation index at: https://betterdatainc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Hosted Gateway Overview

> Production-ready hosted gateway with multi-vendor marketplace features

## What is the Hosted Gateway?

The **Better Data Hosted Gateway** is a fully-managed, production-ready version of the LLM Gateway with enterprise features for multi-vendor marketplaces.

<CardGroup cols={2}>
  <Card title="Fully Managed" icon="cloud">
    99.9% SLA, automatic scaling, and 24/7 monitoring
  </Card>

  <Card title="Multi-Vendor" icon="store">
    Aggregate products from multiple vendors with deduplication
  </Card>

  <Card title="Competitive Ranking" icon="ranking-star">
    10-factor algorithm ranks products by price, shipping, and authenticity
  </Card>

  <Card title="Advanced Analytics" icon="chart-line">
    Attribution, conversion tracking, and A/B testing
  </Card>
</CardGroup>

***

## Open Source vs Hosted

| Feature                   | Open Source  | Hosted                      |
| ------------------------- | ------------ | --------------------------- |
| **Deployment**            | Self-hosted  | Fully managed               |
| **Setup Time**            | 10 minutes   | Instant                     |
| **Vendors**               | Single store | Multi-vendor marketplace    |
| **Product Deduplication** | ❌            | ✅ Fuzzy + GTIN + AI         |
| **Competitive Ranking**   | ❌            | ✅ 10-factor algorithm       |
| **Signal Tags**           | ❌            | ✅ Blockchain authentication |
| **Attribution Analytics** | Basic        | Advanced                    |
| **SLA**                   | None         | 99.9%                       |
| **Support**               | Community    | Priority                    |
| **Pricing**               | Free         | From \$99/month             |

***

## Key Features

### 🏪 Multi-Vendor Marketplace

Connect unlimited vendors via Shopify, Square, or custom integrations:

```typescript theme={null}
// Each vendor gets their own account
POST /api/vendors/connect
{
  "platform": "shopify",
  "domain": "vendor1.myshopify.com"
}

// Products automatically aggregated
GET /api/products/search?q=headphones
// Returns products from all vendors, ranked competitively
```

### 🎯 Product Deduplication

Three-layer matching prevents duplicate listings:

1. **Fuzzy Matching**: Title + brand similarity (90%+ match)
2. **GTIN Matching**: UPC, EAN, ISBN
3. **AI Matching**: Claude determines if products are the same

```typescript theme={null}
// Automatic deduplication
Vendor A: "Apple AirPods Pro (2nd Gen)"
Vendor B: "AirPods Pro 2nd Generation"
→ Matched as same product

// Users see:
AirPods Pro (2nd Gen)
  - Vendor A: $249.00
  - Vendor B: $239.00  ← Best price!
```

### 📊 Competitive Ranking

10-factor algorithm ranks products:

| Factor                     | Weight |
| -------------------------- | ------ |
| Price                      | 25%    |
| Shipping cost              | 15%    |
| Delivery speed             | 15%    |
| Product rating             | 10%    |
| Seller rating              | 10%    |
| In stock                   | 10%    |
| Signal Tag (authenticated) | 10%    |
| Review count               | 5%     |

### 🔐 Signal Tag Authentication

Blockchain-verified product authenticity:

```
Product with Signal Tag = +10% ranking boost

Verified attributes:
✓ Brand authorization
✓ Authentic inventory
✓ GTIN verified
✓ Counterfeit protection
```

### 📈 Attribution Analytics

Track which LLM provider drives conversions:

```typescript theme={null}
// First-touch attribution
User journey:
  1. Claude search → Add to cart
  2. ChatGPT → Complete checkout
     Attribution: Claude (first-touch)

// Last-touch attribution
  Attribution: ChatGPT (last-touch)

// Linear attribution
  Claude: 50%
  ChatGPT: 50%
```

***

## Architecture

```mermaid theme={null}
graph TB
    A[Claude] --> G[Hosted Gateway API]
    B[ChatGPT] --> G
    C[Grok] --> G
    
    G --> D[Multi-Vendor Search]
    G --> E[Deduplication Engine]
    G --> F[Ranking Algorithm]
    
    D --> H[Vendor 1: Shopify]
    D --> I[Vendor 2: Square]
    D --> J[Vendor 3: Custom]
    
    F --> K[PostgreSQL]
    F --> L[Redis Cache]
    
    G --> M[Analytics]
    M --> N[Attribution]
    M --> O[Conversion Tracking]
```

***

## Pricing

<CardGroup cols={2}>
  <Card title="Cloud Free" icon="seedling">
    **\$0/month**

    * 100 req/hr
    * BetterDataRegistry access
    * Basic Analytics
    * Community Support
  </Card>

  <Card title="Hosted" icon="cloud">
    **\$19/month**

    * 1,000 req/hr
    * Pro Provisioning
    * Managed Registry
    * Starter Analytics
  </Card>

  <Card title="Marketplace" icon="cart-shopping">
    **\$99/month**

    * 5,000 req/hr
    * ML-Ranked Discovery
    * Private Federation
    * Realtime Analytics
  </Card>

  <Card title="SCM Pro" icon="building">
    **\$499/month**

    * 20,000 req/hr
    * Global Federation
    * Automated Verification
    * Priority Support
    * Dedicated SLA
  </Card>
</CardGroup>

***

## Getting Started

<Steps>
  <Step title="Sign Up">
    Create your account at [app.betterdata.io/signup](https://app.betterdata.io/signup)
  </Step>

  <Step title="Get API Key">
    Generate your API key in the dashboard
  </Step>

  <Step title="Connect Vendors">
    Use OAuth to connect vendor stores (Shopify, Square)
  </Step>

  <Step title="Configure LLMs">
    Add API credentials for Claude, ChatGPT, Grok
  </Step>

  <Step title="Go Live">
    Start sending traffic to your hosted gateway
  </Step>
</Steps>

***

## API Endpoints

### Search Products

```bash theme={null}
GET https://gateway.betterdata.io/v1/products/search
Authorization: Bearer YOUR_API_KEY

?q=wireless headphones
&limit=10
&vendors=vendor1,vendor2
```

### Get Product Details

```bash theme={null}
GET https://gateway.betterdata.io/v1/products/:id
Authorization: Bearer YOUR_API_KEY
```

### Add to Cart

```bash theme={null}
POST https://gateway.betterdata.io/v1/cart/add
Authorization: Bearer YOUR_API_KEY

{
  "productId": "prod_123",
  "vendorId": "vendor_456",
  "quantity": 2,
  "sessionId": "session_789"
}
```

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Get Started" icon="rocket" href="/hosted/getting-started">
    Set up your hosted gateway
  </Card>

  <Card title="Connect Vendors" icon="plug" href="/integrations/shopify">
    Add Shopify and Square vendors
  </Card>

  <Card title="Configure Analytics" icon="chart-line" href="/hosted/analytics">
    Track attribution and conversions
  </Card>

  <Card title="Billing" icon="credit-card" href="/hosted/billing">
    Manage subscription and usage
  </Card>
</CardGroup>