When using the search_engines filter parameter, you will need the country code and language code to construct the value for the specific search engine you're looking for.

The format for the search_engines field is

{SEARCH ENGINE NAME}|{COUNTRY CODE}|{LANGUAGE CODE}|{DEVICE}|{LOCATION}

For example, if you want to filter by Google in the United States in English on Desktop computers. Just look up "Google" and "United States" in the Country Name column and look for "English" in the Language Name column. You can then see how the "Country Code" and "Language Code" to are used to construct the value for search_engines. In this case that would be:

google|US|en|desktop

The location parameter is optional. If there is no specific location for this search engine, it can be omitted (as shown above). If including it, all commas must be escaped with a "\". For example:

google|US|en|desktop|Los Angeles\, California\, United States

NOTE: This escaping action is only required for GET request where search_engines values are passed along with URL parameters. This will not be necessary for POST or PUT requests because search_engines values are stored in JSON format within the body of the HTTP request.

Lookup Table

Full list of our supported search engines and their ids can be downloaded here (CSV format).

Did this answer your question?