Set Up Real-Time Data Feed Max on BigCommerce

Expose your BigCommerce catalog through the GraphQL Storefront API or a Stencil template

Pro 套餐

What Your Feed Should Look Like

Real-Time Data Feed Max accepts any public URL returning JSON or plain text. The AI reads whatever you give it — products, services, bookable slots, property listings, menus, opening hours, anything — and uses it to answer visitor questions. There is no required shape or field name.

The one exception is Dynamic Product Cards. If you want matching items to render as visual cards in the chat, use these specific field names: name, price, description, image_url, button_link, in_stock.

Example — products (triggers Dynamic Product Cards)

{
  "products": [
    {
      "name": "Wireless Headphones Pro",
      "price": "$149.99",
      "description": "Premium over-ear wireless headphones with ANC.",
      "image_url": "https://example.com/images/headphones.jpg",
      "button_link": "https://example.com/products/headphones",
      "in_stock": true
    }
  ]
}

Example — services (any shape works)

{
  "services": [
    {
      "service": "Deep tissue massage",
      "duration_minutes": 60,
      "price_from": "$95",
      "therapists_available": ["Anna", "Mark"],
      "booking_link": "https://example.com/book/deep-tissue"
    },
    {
      "service": "Haircut & style",
      "duration_minutes": 45,
      "price_from": "$55",
      "booking_link": "https://example.com/book/haircut"
    }
  ]
}

Example — plain text (works too)

Opening hours: Mon-Fri 9-6, Sat 10-4, closed Sunday.
Delivery: Free over $30, minimum order $15, within 5 miles.
Lunch specials (weekdays only):
- Margherita pizza $12
- Caesar salad $9
- Soup of the day $7

Rule of thumb: Use descriptive field names the AI can interpret (service, duration, price, location, etc.). If Dynamic Product Cards make sense for your business, follow the exact field names above. If they don't, use whatever shape fits your data — the AI still searches it and answers questions correctly.

Option 1 — GraphQL Storefront API (recommended)

BigCommerce's GraphQL Storefront API uses a public Storefront Token (not admin credentials) that's safe to hold in a small proxy. This is the cleanest way to expose products to external services.

Create a Storefront API token BigCommerce admin → Settings → API → Storefront API Tokens → Create a token. Choose default scope (read-only) and a long expiration.

Deploy a small proxy Cloudflare Worker, Vercel, or any server. It sends the GraphQL query below to your store's /graphql endpoint with the token, transforms the result, and returns JSON.

Paste the proxy URL into Real-Time Data Feed Max The public URL is the only thing we see — your storefront token stays inside the proxy.

GraphQL query

POST https://store-{hash}.mybigcommerce.com/graphql
Authorization: Bearer YOUR_STOREFRONT_TOKEN

{
  site {
    products(first: 250) {
      edges {
        node {
          name
          description
          path
          prices { price { formatted } }
          defaultImage { url(width: 400) }
          inventory { isInStock }
        }
      }
    }
  }
}

Transform the response in your proxy by mapping each node into our format (name, price, description, image_url, button_link, in_stock).

Option 2 — Stencil Custom Page Template

If you maintain your BigCommerce theme (Stencil), add a custom page template that renders product data as JSON directly — no proxy required.

Add a custom page template to your theme Create templates/pages/custom/page/ai-feed.html in your Stencil theme files.

Use Handlebars to output JSON The products collection is available as context — loop through it and emit your JSON structure.

Push the theme and assign the template to a page BigCommerce admin → Storefront → Web Pages → Add a page → choose ai-feed as the custom template. Note the page URL.

Paste the page URL into Real-Time Data Feed Max For example, your-store.com/ai-feed.

提示： Option 1 (GraphQL) is simpler for most people because you don't have to touch the theme. Go with Option 2 only if you already have theme customization skills and want to keep everything on your domain.

故障排除

I see a password page instead of JSON

Your site is in maintenance, staging, or password-protected mode. Real-Time Data Feed Max needs a fully public URL.

Real-Time Data Feed Max says the feed failed

Open the URL in a private browser window. If you don't see JSON, the URL is wrong or the endpoint is down. If you see JSON but we still fail, the response may be missing a Content-Type: application/json header or exceeding the 10,000,000 character limit.

Product cards don't render

Dynamic Product Cards require specific field names (name, price, image_url, button_link, in_stock). If your platform uses different names, reshape the response in a small custom script before exposing it.

Data looks wrong or outdated

The feed auto-refreshes every 24 hours. For immediate updates, click Refresh Now in Real-Time Data Feed Max. For live fields (price, stock), the AI pulls fresh data on every message — so the 24h cycle only affects which items are known, not their current state.

Feed size exceeded

Real-Time Data Feed Max accepts up to 10,000,000 characters (~25,000 items). If you exceed that, trim fields (skip long HTML descriptions), split your catalog, or use the standard Real-Time Data Feed alongside for secondary data.

Still stuck? Start with the simplest option for your platform and verify the URL works in a browser before pasting it into Real-Time Data Feed Max. You can always upgrade to a more advanced option later — only the URL field changes on our side.

文档