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:
You can only create a search for sites that you can verify your management rights to.
Verification of rights
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:
Configure the export of product information from your database to the YML catalog.
Validate the catalog using Yandex.Webmaster's XML file validator.
Make sure that all links to products contained in the YML catalog lead to the site where you want to place your search.
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.
Creating a new search
To create a new search:
Go to the Search function for online stores page.
Specify the address of the page to contain the search result form. This page can only be placed on a verified site.Restriction. Sometimes, forms of different searches may conflict with each other. If you already have a site search, specify a different search result page than before.
Specify location of the product catalog for the search. The catalog must be located on the same site as the results page.
Save the new search. The new search will be saved under the name “Catalog search http://URL”, where http://URL is the address of your catalog.
The search will only work after the YML catalog is successfully uploaded and indexed. The catalog processing status is available on the search creation page after you click save.
In addition, you will see the number of indexed product offers. If some product offers cannot be indexed, they are excluded from the search, and the catalog status will display a warning.
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:
The search results contain the following information for each of the offers:
Link to the product page.
The first four properties (in their order in the YML catalog).
You can filter the search results:
by the price range.
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.
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.
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:
Select a search from the list on the My search boxes page.
Go to Code to embed on site.
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.
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.