In this article the request to Findologic with all important parameters and information regarding the request is documented.
If any questions occur, please contact our technical support support@findologic.com.

• The Findologic search service is only available after the first succeeded import.
• Queries are sent to Findologic by means of HTTP requests.
• Before each actual query, a so-called Alivetest must be performed.
  • The Alivetest returns either alive or dead. If dead is the case, a fallback mechanism must take effect, and the conventional shop search must process the query.

• Before each query, an Alivetest HTTP request is sent to Findologic according to the following pattern:
  • http://service.findologic.com/ps/<SHOP_URL>/alivetest.php?shopkey=<SHOPKEY>.
• In the case of a response from alive, the actual query is sent to the Findologic service.
• With all other responses other than alive, the query is processed by the conventional shop search.
  If the fallback mechanism is not working properly, the Findologic search may not be used in a productive shop.
• Also, a timeout of 1 second must be set for the Alivetest. If the response time exceeds 1 second, the query is processed by the conventional shop search.
• A timeout of 3 seconds must be set for the actual query. If the response time exceeds 3 seconds, the query is processed by the conventional shop search.

The request is composed of the following components:

• Service-URL
• Required parameters
  • shopkey
  • shopurl
  • userip
  • referer
  • revision
• Search parameters
  • query
  • attrib[]
  • order
  • properties[]
  • outputAttrib[]
  • pushAttrib[][]
• Restriction / paging parameters
  • count
  • first
  • identifier
  • group[]

All parameters keys and their values must be submitted UTF-8 and URL encoded.

attrib[Färbung][]=grün => attrib[F%C3%A4rbung][]=gr%C3%BCn

To build the request URL, use existing functions if possible. The request is automatically correctly coded with these. In PHP for example, the function is http_build_query:

$parameters = array(
  'shopkey' => 'ABCDABCDABCDABCDABCDABCDABCDABCD',
  'attrib' => array(
    'cat' => array(
      'Cars'
    ),
  ...
  ),
);
$requestUrl = 'http://service.findologic.com/ps/my-shop.com/index.php?' . http_build_query($parameters);

The following are examples of queries: