Machine-readable catalog data

AI Product Feed

AI Product Feed creates machine-readable product exports and shows whether products contain the information needed for stricter merchant-feed formats.

Try it on your storeThree steps to check this feature
  1. 1Choose one store and one language; review Public AI Catalog versus OpenAI Merchant Feed requirements.
  2. 2Run the readiness checker and generate a feed only if the inputs are appropriate.
  3. 3Open or download the generated feed URL and check a few entries for correct product links and descriptions.
What confirms it works

The feed contains valid, current product records for the selected store and language. Third-party acceptance and ingestion are not guaranteed.

Remember: A public catalog export is not the same as approval for a merchant shopping program. Frontend verification guide →

Store + Language awareRecommended setup

Two different things are shown on this page

Public AI Catalog

A generic HuntBee JSON catalog that can expose machine-readable product data. It is not the same as a registered merchant feed and does not guarantee ingestion or ranking.

OpenAI Merchant Feed

A generated merchant-feed snapshot using the supported compatibility profile. Creating the file does not automatically upload it or enroll the store with OpenAI.

Why are Store and Language required?

Feed URLs, product URLs, availability and language-specific text depend on the selected store and language. This is why both selectors belong on this component.

Example: English for Store A and French for Store B can produce different product URLs, titles/descriptions and feed files even when both stores use the same OpenCart installation.

What is Merchant Feed Readiness?

Readiness is a diagnostic check. HuntBee scans active products for fields commonly required by the merchant-feed export, such as usable title/description, product URL, image, brand, price, availability and product identifiers.

Recheck Products updates this diagnostic information. It does not change the product and it does not submit anything to an external service.

Important: a product can still appear in the generic Public AI Catalog even if it is not “Merchant Ready”. Merchant readiness is the stricter check.

What does the Product Readiness tab do?

It is a work list. It tells you which products are ready and which need attention before a stricter merchant export can contain complete data.

Column/actionMeaning
Merchant ReadyThe current product passes the readiness checks for the selected Store + Language.
Needs AttentionOne or more required/important feed fields are missing.
Missing DataClear reason, for example missing brand or GTIN/MPN.
Edit ProductOpens the normal OpenCart product editor so you can correct the source data.
Preview Feed DataShows the record HuntBee would generate for that product.
Mark No IdentifierUse only when the product genuinely has no GTIN/MPN. Do not use it merely to hide a warning.

The footer shows results in a normal pagination summary such as Showing 1–22 of 22 products, so you can tell whether you are seeing the complete list.

What happens when I click Generate Merchant Feed?

  1. HuntBee reads eligible products for the selected Store + Language.
  2. The export is generated in bounded chunks so large catalogs do not need one huge request.
  3. You see progress while the file is being built.
  4. When complete, the status, last-generated time, file size and Download action update.
It does not submit the feed to OpenAI. Generating a local file is only the export step. External onboarding/registration and feed acceptance are separate processes.

Recommended settings

SettingRecommended starting pointWhy
Enable Public AI CatalogEnable if you intentionally want HuntBee's machine-readable catalog available.It is optional discovery infrastructure, not a ranking switch.
Products per pageKeep the default unless you have a performance reason to change it.Controls the public JSON pagination size.
File cacheEnable on normal production stores.Reduces repeated work.
Cache lifetimeDefault is normally fine.Balance freshness against repeated generation work.
Merchant Feed automationLeave off initially.Enable only after a snapshot has been generated manually and you actually want automatic refresh.

Recommended workflow

Choose Store + Language
Recheck Product Readiness
Fix important missing product data
Preview a few product records
Generate Merchant Feed only if you need it
Enable Cron refresh only after manual generation works

Do I need every product to be 100% ready?

No. Use the readiness screen to improve commercially important products first. A diagnostic count is not a ranking score. Fix missing brand/identifier/product data because it improves feed quality, not just to make a number turn green.

Troubleshooting

  • Feed Ready is 0: open Product Readiness and read the Missing Data reasons.
  • Generate button appears to do nothing: wait for the progress/status alert. Large stores run in chunks.
  • Generated file is tiny: check how many products are Merchant Ready and whether the selected store/language has active products.
  • Automatic refresh does not run: check Cron Manager Scheduler Health and the AI Product Feed Refresh job.