Confirm if an IP address is used by YandexBot

1 Enter IP address
2 See result
Latest YandexBot user agents detected
YandexBot Mobile User Agent

Mozilla/5.0 (iPhone; CPU iPhone OS 8_1 like Mac OS X) AppleWebKit/600.1.4 (KHTML, like Gecko) Version/8.0 Mobile/12B411 Safari/600.1.4 (compatible; YandexMobileBot/3.0; +http://yandex.com/bots)

YandexBot Desktop User Agent

Mozilla/5.0 (compatible; YandexBot/3.0; +http://yandex.com/bots)

YandexBot API documentation

The YandexBot API makes it easy to check if an IP address is officially used by YandexBot to crawl the web, including your website.

The YandexBot API is a 'REST API' which is accessible via HTTPS using the GET method at a predefined URL. It returns either JSON of plain text response.

Benefits of using the YandexBot API are:

  • Querying the YandexBot API is free of charge and anonymous.
  • The YandexBot API works across applications and scripting languages, e.g. see below the Google Spreadsheets and Python implementations.
  • The YandexBot API contains historical records, which means that IP addresses which may have been once used but are currently not resolving can still be identified when performing log file analysis on historical logs.
  • As YandexBot is crawling the web, the database for the YandexBot API is continuously and automatically updated with the latest IP addresses and user agents.
  • Instead of performing two seperate lookups (forward and reverse) with the 'host' command on the command line locally, this API provides a single lookup method which can be accessed from anywhere.
  • The YandexBot API contains one of the largest freely and publicly accessible collection of IP addresses for YandexBot.

This YandexBot API is coded and provided by ex-Google engineer and technical SEO expert Fili.

Authentication

This YandexBot API is free of charge and can be accessed without credentials. However, depending on resource usage the API may become rate-limited in the future. If you have any questions about using the YandexBot API on a larger scale or like to discuss ways to utilize this database internally, contact Fili.

Quickstart guide

You can query the API endpoint using a GET request and replace IPADDRESS with the IP address you wish to query.

GET Request
Endpoint definitions

By default the API will return a JSON response with:

  • a body containing "valid": "true" if the queried IP address is found in the database,
  • or a body containing "valid": "false" if the queried IP address is not found in the database.

Alternatively, it is also possible to request just a BOOLEAN in plain text (useful in some situations, e.g. Google Spreadsheets - see below).

URL parameters which are accepted by the YandexBot API are:

URL ParameterValue
ip(string) IP address, IPv4 or IPv6
compact(integer) default is 0 and return JSON response, 1 will return a plain text response

Code snippets

Here are some examples of how to query the YandexBot API:

Command line (curl) Example 1

It is also possible to use this API with Google Spreadsheets by adding &compact=1 to the API URL.

In the following example, the content of cell A1 contains the IP address to check and replaces in the =IMPORTDATA formula the __IPADDRESS__. Be sure to replace the cell ID when using this in Google Spreadsheets.

Google Spreadsheets

It is also possible to use this API in your code with python or similar other languages.

Python 3
Example responses

When the URL parameter compact is missing or has a value of 0 (zero) the API returns a JSON response with a queried IP address, query timestamp and boolean if the IP address validates.

Example 1: JSON response
Example 2: JSON response

When the URL parameter compact is present and has a value of 1 (one) the API returns a plain text response with a boolean if the IP address validates.

Example 3: plain text (compact) response
Example 4: plain text (compact) response
Disclaimer

The data shown on this website is automatically collected from multiple sources, mostly websites and domains under the control of ex-Google engineer Fili. Despite best efforts to maintain data quality, no guarantees can or will be given. Data may be incomplete and/or errors may occur. This is a personal website and for-fun project. Use at your own risk.