YandexBot API

Latest YandexBot user agents detected

YandexBot mobile user agent

Mozilla/5.0 (iPhone; CPU iPhone OS 15_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.4 Mobile/15E148 Safari/604.1 (compatible; YandexMobileBot/3.0; +http://yandex.com/bots)

YandexBot desktop user agent

Mozilla/5.0 (compatible; YandexBot/3.0; +http://yandex.com/bots) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/108.0.0.0

Fili

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. 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.

        https://yandexbot.seoapi.com/v1/validate/?ip=IPADDRESS

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

        curl -i https://yandexbot.seoapi.com/v1/validate/?ip=87.250.224.39

It is also possible to use this API in 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

        =IMPORTDATA(SUBSTITUTE("https://yandexbot.seoapi.com/v1/validate/?ip=__IPADDRESS__&compact=1","__IPADDRESS__",A1))

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

Python 3

        import requests

r = requests.get(
    'https://yandexbot.seoapi.com/v1/validate/?ip=87.250.224.39'
).json()
print(r.get('valid', None))

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

        {
    "ip": "87.250.224.39",
    "timestamp": 1615471876.25665,
    "valid": true
}

Example 2: JSON response

        {
    "ip": "127.0.0.1",
    "timestamp": 1615471876.25665,
    "valid": false
}

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

        true

Example 4: plain text (compact) response

        false

Latest IP addresses added

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. The SEO APIs on this website are under constant development and improvements will be added over time.

Any data and/or query submitted to this website or its APIs are only used to verify whether an IP address is associated with a known search bot. When not, the IP address (or any other submitted data) is completely disregarded and ignored. Only after an IP address is separately confirmed to be a search bot IP address, the IP address is anonymously stored for future queries.

Bugs will happen. Despite best efforts to maintain the code base and 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.