SearchX Documentation — AI-Powered E-Commerce Search

Import your products using Facebook Catalog XML feed format.

Overview

SearchX can import products from Facebook Catalog feeds. This format is commonly used for Facebook and Instagram Shopping.

Feed Format

Your feed should follow the Facebook product catalog specification:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:g="http://base.google.com/ns/1.0">
  <title>My Store Catalog</title>
  <!-- Both <entry> and <item> tags are supported -->
  <entry>
    <g:id>SKU-001</g:id>
    <g:title>Example Product</g:title>
    <g:description>A great product description.</g:description>
    <g:link>https://www.mystore.com/products/example</g:link>
    <g:image_link>https://www.mystore.com/images/example.jpg</g: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:condition>new</g:condition>
  </entry>
  <item>
    <g:id>SKU-002</g:id>
    <g:title>Another Product</g:title>
    <g:link>https://www.mystore.com/products/another</g:link>
    <g:image_link>https://www.mystore.com/images/another.jpg</g:image_link>
    <g:price>19.99 EUR</g:price>
    <g:availability>in stock</g:availability>
  </item>
</feed>

Required Fields

Field	Description
`g:id`	Unique product identifier
`g:title`	Product name
`g: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
`g:price`	Product price with currency
`g:availability`	Stock status
`g:sale_price`	Discounted price
`g:brand`	Brand name
`g:product_type`	Category path
`g:condition`	Product condition
`g:gender`	Target gender
`g:age_group`	Target age group

Setting Up

Navigate to Applications in the SearchX Dashboard.
Set your feed URL and select Facebook Catalog as the feed type.
Click Import Products.

Format Differences

SearchX automatically handles both <item> and <entry> tags, so your feed will work regardless of which format it uses. Only 3 fields are strictly required.