SearchX Documentation — AI-Powered E-Commerce Search

Import your products using Google Merchant Center (RSS 2.0) XML feed format.

Overview

SearchX supports importing products from Google Merchant Center XML feeds. This is the most common feed format used by e-commerce platforms and is widely supported by shopping platforms.

Feed Format

Your feed must follow the Google Merchant Center product data specification. Here's an example of the expected XML structure:

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">
  <channel>
    <title>My Store Products</title>
    <link>https://www.mystore.com</link>
    <description>Product feed for My Store</description>
    <item>
      <g:id>SKU-001</g:id>
      <title>Example Product</title>
      <description>A great product for your needs.</description>
      <link>https://www.mystore.com/products/example</link>
      <g:image_link>https://www.mystore.com/images/example.jpg</g:image_link>
      <g:additional_image_link>https://www.mystore.com/images/example-2.jpg</g:additional_image_link>
      <g:price>29.99 EUR</g:price>
      <g:sale_price>24.99 EUR</g:sale_price>
      <g:availability>in_stock</g:availability>
      <g:brand>Brand Name</g:brand>
      <g:product_type>Category > Subcategory</g:product_type>
      <g:google_product_category>Apparel &amp; Accessories</g:google_product_category>
      <g:condition>new</g:condition>
      <g:color>Blue</g:color>
      <g:size>M</g:size>
      <g:gender>male</g:gender>
      <g:age_group>adult</g:age_group>
      <g:item_group_id>VARIANT-GROUP-001</g:item_group_id>
    </item>
  </channel>
</rss>

Required Fields

Field	Description
`g:id`	Unique product identifier
`title`	Product name
`link`	URL to the product page

g:id and product identification

The g:id value is exposed as unique_id in SDK events (e.g., SearchX:addToCart). If you use these events to interact with your own backend, make sure g:id matches the identifier your API expects — typically your database primary key. See Event Handling for details.

Optional Fields

Field	Description
`g:image_link`	Main product image URL (optional to support edge-case catalogs)
`g:price`	Product price with currency (optional to support free items)
`g:availability`	Stock status: `in_stock`, `out_of_stock`, `preorder`
`description`	Product description
`g:sale_price`	Discounted price
`g:brand`	Brand name
`g:product_type`	Category path
`g:color`	Product color
`g:size`	Product size
`g:additional_image_link`	Additional product images
`g:condition`	Product condition: `new`, `refurbished`, `used`
`g:gender`	Target gender
`g:age_group`	Target age group
`g:shipping`	Shipping details block
`g:item_group_id`	Variant group ID for grouping product variants
`g:google_product_category`	Google product taxonomy category

Setting Up

Go to the SearchX Dashboard.
Create a new application or edit an existing one.
Paste your Google Merchant XML feed URL.
Select Google Merchant as the feed type.
Click Import Products.

Google Feed Setup — Configuring a Google Merchant feed in the SearchX dashboard.

Feed Validation

SearchX is lenient when validating feeds — it only strictly enforces ID, Title, and Link. Other fields are imported when present but won't block your import if missing. Check the import log for detailed messages if anything looks off.

Troubleshooting

Feed not accessible — Ensure your feed URL is publicly accessible. SearchX needs to fetch the feed directly.
Missing products — Check that all required fields are present for each item.
Price format — Prices must include a currency code (e.g., 29.99 EUR).