Frequently Asked Questions

The answers are all here. To any Sooqr-related questions, obviously. Can't find the answer to your question? Maybe you can find it in our Support Portal. Still in need of more knowledge? Try us on support@sooqr.com. And for very urgent matters, please give us a ring +31 (0)88 7667700. Our Support-Troopers won't bite. Promise.

What should my data feed look like?

Feeds should be UTF-8 encoded.

  • Only use absolute URL's; include the protocol and domain name. (Example: 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 ).
  • 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 is best to remove HTML from your data feed. 
  • 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 the W3C Markup Validation Service.
  • For an example of what a data feed should look like please check Sooqr Support for specs.

What platforms can I use Sooqr on?

Sooqr can be used on and with any platform. All Sooqr needs is a data feed. In return, we will give you a snippet to implement Sooqr. To make life just that little bit easier, we have developed a few extensions for certain platforms. Now available are the Sooqr Search plugins for Magento 1, Magento 2 and Shopware. Extensions for Woocommerce, Shopify and Lightspeed are being developed at the moment.

Is my XML feed valid for Sooqr?

You can validate your XML feed at the W3C Markup Validation Service.

How do I implement a snippet and data feed?

Step 1: Placing our snippet on your website
Place the provided snippet on your website, somewhere between the search bar and the end of your page.

Step 2: Change the ID of the search bar to 'Search'
This needs to be a unique value, so we know which input field to use. If it’s impossible to adjust the ID of your search bar, you can try to change the field ID: ’Search’ in the snippet, to the ID of your input field.

Step 3: Add a data feed
To see how it’s done, check this video.

How do I add CMS content to my product search?

We often get the question whether it is possible to add both CMS content and product-content. Sure; there’s just a few things you need to keep in mind.

  • You can add the content to your product feed, but it’s easier to add a separate content feed.
  • Make sure your ID is unique, as the same goes for the product feed. It is best to have a trailing text in front of the ID, for example, content_623, instead of 6. 
  • The naming of the fields should be the same as your product feed (ID, title, description, URL, image). 
  • Add a field 'content_type' to both your product feed and content feed, so you can base a filter on it.
  • For an example, please take a look on our support portal: support.sooqr.com

What about the pricing?

Pricing for Sooqr is based on a maximum of five requests per second (that's almost 13 million requests per month) and installation on one domain. We bill on the amount of data, SKU, you send us (content and/or product), instead of the number of searches. Feel free to contact our Sales Team for any additional questions or plans. 

Help! I'm growing!

Whenever your number of SKU outgrows your plan, your plan will automatically grow with you. Of course whenever your number of SKU’s decreases, your plan will do so too. You won’t be billed for an increase of SKU during the month.

What about a contract?

We don’t work with long-term contracts. Our contracts are monthly and our Search can be cancelled at any giving time. So, whenever you think Sooqr isn’t doing a great job: just can end using it. Yet, we would love to know why, so we can optimise our services.