How to Scrape Yandex Search Results: A Step-by-Step Guide

Setting up the environment

Begin by downloading and installing Python from the official website. If you already have Python installed, make sure you have the latest version. 

To scrape Yandex, we’ll use three Python libraries: requests, Beautiful Soup, and pandas. You can install them using Python’s package manager pip with the following command: 

pip install requests pandas beautifulsoup4

The requests module will enable you to interact with the API by making network requests, the Beautiful Soup library will help you extract specific data, and then store the results using pandas. 

Yandex Scraper API query parameters 

Since the Yandex Scraper API is part of our SERP Scraper API, let’s get to know some query parameters for a smooth start.

The main parameters you should use are:

• source – use universal as a value to access our scraper;

• url – provide a link to the Yandex search results page. See our documentation on how to form Yandex URLs. Additionally, check out this Yandex documentation for specific geo-location values you can use in the URL;

• geo_location – uses our proxy server pool to change the IP address of requests;

• render – enables JavaScript rendering.

Visit our documentation to find out more about parameters and their values.

Scraping Yandex Search Pages for any keyword

Now that everything’s ready, let’s write a Python script to interact with the Yandex SERP and retrieve results for any keyword.

1. Import required libraries

Start by importing the libraries that you’ve installed in the previous step:

import requests
from bs4 import BeautifulSoup
import pandas as pd

2. Prepare a payload

Next, prepare a payload as shown below:

payload = {
    'source': 'universal',
    'url': f'https://yandex.com/search/?text=what%20is%20web%20scraping',
    'geo_location': 'Germany',
    'render': 'html'
}

Using the above payload, we’re searching Yandex for the term “what is web scraping.” The code tells the scraper to retrieve search results that only include websites with the domain .com, while also routing the request through a German proxy server. The 'render': 'html' parameter enables JavaScript rendering, which helps to overcome Yandex anti-scraping measures.

3. Send a POST request

Next, we need to make a POST request to the Yandex Scraper API. To do that, use the requests library you’ve imported previously:

credentials = ('USERNAME', 'PASSWORD')
response = requests.post(
    'https://realtime.oxylabs.io/v1/queries',
    auth=credentials,
    json=payload,
    timeout=180
)

Note that we have declared a tuple named credentials. For the code to work, you’ll have to replace the USERNAME and PASSWORD with the API authentication credentials. If you don’t have them, you can sign up and get a 1-week free trial.

We use the POST method of the requests library to send the payload to the URL https://realtime.oxylabs.io/v1/queries. We also pass the authentication credentials and the payload as JSON. 

Next, let’s print the result with the following line:

print(response.json())

It’ll print the entire API response. A successful Yandex scraping request will return a 200 status code, but if you encounter a different response, we recommend visiting our documentation, where we’ve detailed common response codes.

4. Parse the data with Beautiful Soup

You can easily parse the scraped Yandex search results by using a library like Beautiful Soup. Check out our in-depth Beautiful Soup tutorial to learn how to use it. You can also utilize our free Custom Parser feature for hassle-free HTML parsing.

First, define an empty data list and create a BeautifulSoup instance:

data = []
content = response.json()['results'][0]['content']        
soup = BeautifulSoup(content, 'html.parser')

Then, create a for loop that extracts the h2 title and and its href URL for each li element in the result:

for element in soup.find_all('li'):
    h2_element = element.select_one('h2 > span')
    h2 = h2_element.text if h2_element else None
    link_element = element.select_one('.organic__url')
    link = link_element.get('href') if link_element else None
    data.append({'Title': h2, 'Link': link})
    
print(data)

5. Export data into a CSV/JSON file

To export the data into a CSV or JSON format, you must first create a data frame:

df = pd.DataFrame(data)

With this code, you’re using the pandas library to pass the data list of parsed results. Now, you can simply export the data frame into CSV as below:

df.index += 1
df.to_csv('yandex_results.csv', index=True)

Similarly, you can export the results into JSON using the following code:

df.to_json('yandex_results.json', orient='records', indent=4)

Once you execute the code, the script will create two new files in the current directory with the scraped results.

Complete Yandex scraping code

import requests
from bs4 import BeautifulSoup
import pandas as pd

payload = {
    'source': 'universal',
    'url': f'https://yandex.com/search/?text=what%20is%20web%20scraping',
    'geo_location': 'Germany',
    'render': 'html'
}

credentials = ('USERNAME', 'PASSWORD')
response = requests.post(
    'https://realtime.oxylabs.io/v1/queries',
    auth=credentials,
    json=payload,
    timeout=180
)
print(response.json())

data = []
content = response.json()['results'][0]['content']        
soup = BeautifulSoup(content, 'html.parser')

for element in soup.find_all('li'):
    h2_element = element.select_one('h2 > span')
    h2 = h2_element.text if h2_element else None
    link_element = element.select_one('.organic__url')
    link = link_element.get('href') if link_element else None
    data.append({'Title': h2, 'Link': link})

df = pd.DataFrame(data)
df.index += 1
df.to_csv('yandex_results.csv', index=True)
df.to_json('yandex_results.json', orient='records', indent=4)

Running the above code will output a CSV file that should look similar to this:

Conclusion 

While scraping Yandex SERPs is extremely challenging, by following the steps outlined in this article and using the provided Python code, you can easily scrape Yandex search results for any chosen keyword and export the data into a CSV or JSON file. With the help of Yandex Scraper API, you can bypass Yandex's anti-bot measures and scrape SERPs at scale.

If you require assistance or want to know more, feel free to contact us via email or live chat.