Yandex Search API

Basic Information

Interface Description: Retrieve real-time search data from Yandex via API.

Interface URL: https://scraperapi.thordata.com/request

Request Method: POST

Request parameters

Headers：

Parameter name	Type	Required	Describe
token	string	Yes	Please log in to the Dashboard-account-settings to view your token

Body：

Parameter	Type	Required	Description
text	string	Yes	Defines the search query for scraping (default: q=pizza). For a list of possible values, see Query Parameter
json	string	No	This parameter defines the output format of the crawl results. json=1 for JSON, json=2 for both, json=3 for HTML.
url	string	Yes	Domain for scraping (default yandex.com)
lang	string	No	This parameter defines the language of the search results.For a list of possible values, see lang parameter
lr	string	No	This parameter defines the language of the search result.For a list of possible values, see lr parameter
rstr	string	No	Double filtering - enforces results to match either the specified region (lr) or enables SafeSearch (e.g., rstr=family blocks adult content). For a list of possible values, see family parameter
p	string	No	Pagination control (starts from p=0), must be used with the results-per-page parameter.For a list of possible values, see page parameter.
within	string	No	Time range to search. Available values are: 77 - Past 24 hours 1 - Past 2 weeks [%pm] - Past month. For a list of possible values, see site/date parameters

Response example

    {
    "spider_parameter": {
        "engine": "Yandex",
        "text": "pizza"
    }
    "search_metadata": {
        "created_at": "2025-06-21 14:08:06",
        "id": "xxx",
        "url": "https://yandex.com/search?text=pizza"
    },
    "result":{}

Parameter Name	Type	Required	Description
spider_parameter	object	yes	Search engine parameters configuration
engine	string	yes	Search engine type
text	string	yes	Search keyword
search_metadata	object	yes	Metadata of the search
created_at	string	yes	Timestamp of the search
id	string	yes	Unique task ID
url	string	yes	Full URL of the search request
result	string	yes	Return Result