• Only use absolute URL's; include the protocol and domain name. (For an example, see http://www.example.com/article-1.html)
  • You can choose your own names when naming fields. Yet each parent item-node should have the same name (for example <item>).
  • All meta-data for an item should be on the first level of the XML file under the item node. Exceptions to this rule are nodes that contain multiple values, like colors or categories. These values can be stored in a subnode.
  • Each item has to contain an ID field. The ID must be unique in your feed and can contain alphanumeric characters.
  • The use of HTML in your data is not supported. Sooqr will remove HTML from your input, because we cannot use it in the search tool. Although Sooqr will do her best to clean-up your data, it's best to remove HTML from your datafeed.
  • Date values should use the RFC3339 format. All timings should be in the UTC time zone (example: 2012-02-31T15:00:00Z).
  • Each item should at least contain an ID, title and URL.
  • URL's and values containing markup should be contained in CDATA nodes.
  • Floating point numbers (like prices) should use the decimal point.
  • If metadata is not available, you can remove the node from the output. This will also improve the size of the feed.
  • You can validate your XML feed at http://validator.w3.org.
  • An example of what your feed could look like:


    <?xml version="1.0" encoding="utf-8"?>
    <items>     
        <item>         
            <id>235</id>
            <title>Sapphire ATI Radeon HD5450 1GB</title>
            <url><!CDATA[http://www.example.com/product?id=235]]></url> <productcode>2346562</productcode>
            <type/>
            <categories>
                <category>Computers</category>             
                <category>Hardware</category>         
            </categories>
            <subcategories>
                <subcategory>Videokaart</subcategory>
                <subcategory>VGA</subcategory>
            </subcategories>
            <sizes>
                <size>Small</size>
                <size>Medium</size>
                <size>Extra large</size>
            </sizes>
            <productbrandname/>         
            <eancode>4895106250475</eancode>
            <text><![CDATA[<p><b>Sapphire ATI Radeon</b></p>]]></text>
            <imageurl><!CDATA[http://www.example.com/ati.jpg]]></imageurl>
            <price>30.00</price>
            <from_price>40.00</from_price>
            <shippingcosts>0.00</shippingcosts>
            <sale>1</sale>
            <orderurl><!CDATA[http://www.example.com/order/ati.htm]]></orderurl>     
        </item>     
        <item>        
        [..]     
        </item>
    </items>