Online store search (beta)

Online store search was specially developed by Yandex to enable search in catalogs of online stores and marketplaces. The search uses an index based on the YML catalog, and the search results are optimized to display product details.

Online store search allows you to:

  • Search for a product by name or description.

  • Search products “in stock” and “available on order”.

  • Filter results by price and category.

  • Get the main properties of the product and its image in search results.

    Creating an online store search

    To create a new online store search:

    1. Verify your right to manage the site.

      You can only create a search for sites that you can verify your management rights to.

    2. Prepare your product catalog for search.

      Product catalog — a YML document with the list of product offers and their main properties. The search index is based on the catalog.

    3. Create a new search under your account.

      In the Search function for online stores page, specify the parameters for the new search: the catalog location and the result page address.

    When the new online store search is ready, you can install it on your site. You can change the search settings, if needed.

    Verification of rights

    You can only create searches for the sites you have rights to manage. To confirm your rights to the site, use Yandex.Webmaster. Read more in Yandex.Webmaster Help.

    Creating and placing the product catalog

    The catalog is a list of product offers in the YML format. Requirements for YML documents can be found in Yandex.Market Help. The catalog must be created and placed so that the search robot can download and index it regularly.

    To prepare the catalog:

    1. Configure the export of product information from your database to the YML catalog.

    2. Validate the catalog using Yandex.Webmaster's XML file validator.

    3. Make sure that all links to products contained in the YML catalog lead to the site where you want to place your search.

    4. Place the catalog on your site so that the search bot can download and index it. The catalog will be indexed once a day.

    When preparing the YML catalog, keep in mind the following specifics of the online store search:

    • Only one image per each product offer can be displayed in the search results. If the offer contains multiple images, one of them is chosen randomly.

    • If several product offers link to the same page, only one of them will be displayed in the search results randomly.

    Validating search results

    Before placing a new search on your site, you can check how its results are displayed. To do this, open the My search boxes, select a search from the list, and go to the Test your search section.

    Search works correctly if:

    1. The search results contain the following information for each of the offers:

      • Name.

      • Price.

      • Category.

      • Brief description.

      • Link to the product page.

      • Image.

      • The first four properties (in their order in the YML catalog).

    2. You can filter the search results:

      • by category;

      • by availability;

      • by the price range.

    3. You can sort the search results by price.

    If the search or form doesn't work as you expected, double check the settings you made in the previous steps. If the error persists, write to us, specifying your username and name of the faulty search.

    Editing an online store search

    You can change the addresses for the results page and YML search catalog on the My search boxes page. To do this, select a search from the list and go to Catalog search. In this section, you can view the current addresses and change them.

    Attention. The addresses for the results page and YML search catalog must belong to the same verified site. You can verify your rights to the website in Yandex.Webmaster.

    The section also displays the search status details:

    • YML catalog processing status.

    • Date and time when the catalog was last indexed.

    • Number of indexed product offers.

    • Error codes.

    Adding an online store search to your site

    To add a search to your site, place your search form and search results form on it. To do this, copy the form code and paste it into the HTML code of your site page:

    1. Select a search from the list on the My search boxes page.

    2. Go to Code to embed on site.

    3. Select the encoding and language of your site.

      Yandex automatically detects the site encoding, but if the automatic detection fails, you can specify your text encoding manually.

    4. Copy the code of the forms and place them as follows:

      • Place the search form on any page of your site.

      • Place the results form on the page you specified when creating the search. Place a copy of the search form on the same page.

        Restriction. Your search will not work if there is no search form on the results page.

    Getting search results in JSON format

    Besides the search form requests, online store search also supports requests via Yandex Site Search API. The response to this request is returned in the JSON format.

    You can use the API to create applications for sending search queries and displaying results in any format. Read more about the API access and requests in the API description.