Logo SearchApi

Yandex Search API Documentation

GET   /api/v1/search?engine=yandex

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    Parameter defines the query you want to search. You can use anything that you would use in a regular Yandex search.

Localization

  • Name
    location
    Required
    Optional
    Description

    Parameter defines from where you want the search to originate. Check the full list of supported Yandex locations.

  • Name
    yandex_domain
    Required
    Optional
    Description

    The default parameter yandex.com defines the Yandex domain of the search. Check the full list of supported Yandex yandex_domain domains.

  • Name
    lang
    Required
    Optional
    Description

    Parameter defines the interface language of the search. Check the full list of supported Yandex lang languages.

Filters

  • Name
    time_period
    Required
    Optional
    Description

    This parameter restricts results to URLs based on date. Supported values are:

    • last_day - data from the past 24 hours.
    • last_two_weeks - data from the past 2 week.
    • last_month - data from the past month.

Pagination

  • Name
    page
    Required
    Optional
    Description

    Specifies the page of results to return. The default value is 1. Only the first four pages (1-4) are supported.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to yandex.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Knowledge Graph

Knowledge Graph
GET
https://www.searchapi.io/api/v1/search?engine=yandex&q=Elon+Musk
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "yandex",
  "q": "Elon Musk"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "knowledge_graph": {
    "title": "Elon Musk",
    "description": "Businessman and investor known for his key roles in the space company SpaceX and the automotive company Tesla, Inc. Other involvements include ownership of X Corp., the company that operates the social media platform X (formerly known as Twitter),…",
    "source": {
      "name": "Wikipedia",
      "link": "http://en.wikipedia.org/wiki/Elon Musk"
    },
    "born": "June 28, 1971 (53 years), Pretoria, Southern Africa",
    "born_links": [
      {
        "text": "Pretoria",
        "link": "https://yandex.com/search/?text=Pretoria&lr=10130&noreask=1&ento=0oCghydXc0NjEyMxgDKgpydXcxNzUwMTE3aglFbG9uIE11c2tyBEJvcm5Q_lmg"
      }
    ],
    "height": "186 cm",
    "married_to": "Talulah Riley (2013-2016), Justine Musk (2000-2008)",
    "married_to_links": [
      {
        "text": "Talulah Riley",
        "link": "https://yandex.com/search/?text=Talulah%20Riley&lr=10130&noreask=1&ento=0oCgpydXcxNDA0NjMyGAMqCnJ1dzE3NTAxMTdqCUVsb24gTXVza3IJU3BvdXNlQG9uaFX1IQ"
      },
      {
        "text": "Justine Musk",
        "link": "https://yandex.com/search/?text=Justine%20Musk&lr=10130&noreask=1&ento=0oCgpydXc5MDY4NzY2GAMqCnJ1dzE3NTAxMTdqCUVsb24gTXVza3IJU3BvdXNlQG9uwo31Jw"
      }
    ],
    "dated": "Grimes",
    "dated_links": [
      {
        "text": "Grimes",
        "link": "https://yandex.com/search/?text=Claire%20Boucher&lr=10130&noreask=1&ento=0oCgpydXczNjc3MzIxGAMqCnJ1dzE3NTAxMTdqCUVsb24gTXVza3IFRGF0ZWTj7DTW"
      }
    ],
    "parents": "Maye Musk, Errol Musk",
    "parents_links": [
      {
        "text": "Maye Musk",
        "link": "https://yandex.com/search/?text=Maye%20Musk&lr=10130&noreask=1&ento=0oCgpydXc3NDI2NDQ0GAMqCnJ1dzE3NTAxMTdqCUVsb24gTXVza3IHUGFyZW50cxMFuRU"
      },
      {
        "text": "Errol Musk",
        "link": "https://yandex.com/search/?text=Family%20of%20Elon%20Musk&lr=10130&noreask=1&ento=0oCgtlbnc3NzIzNzczNxgDKgpydXcxNzUwMTE3aglFbG9uIE11c2tyB1BhcmVudHNRRZZs"
      }
    ],
    "children": "Kai Musk, Griffin Musk, Damian Musk, Saxon Musk, Vivian Jenna Wilson, X Æ A-Ⅻ Musk, Azure Musk, Strider Musk, […]Kai Musk, Griffin Musk, Damian Musk, Saxon Musk, Vivian Jenna Wilson, X Æ A-Ⅻ Musk, Azure Musk, Strider Musk, Tau Musk, Exa Musk",
    "children_links": [
      {
        "text": "Kai Musk",
        "link": "https://yandex.com/search/?text=Kai%20Musk&lr=10130&noreask=1&ento=0oCgx3a2RxOTc1NzI0MjkYAyoKcnV3MTc1MDExN2oJRWxvbiBNdXNrcghDaGlsZHJlbko6_xk"
      },
      {
        "text": "Damian Musk",
        "link": "https://yandex.com/search/?text=Damian%20Musk&lr=10130&noreask=1&ento=0oCg13a2RxMTAxNjc1MjM0GAMqCnJ1dzE3NTAxMTdqCUVsb24gTXVza3IIQ2hpbGRyZW4_OYI-"
      },
      ...
    ],
    "profiles": [
      {
        "name": "Instagram",
        "link": "http://www.instagram.com/elonmusk"
      },
      {
        "name": "TikTok",
        "link": "http://www.tiktok.com/@elonmuskb"
      },
      {
        "name": "Twitter",
        "link": "http://twitter.com/elonmusk"
      }
    ],
    "see_also": [
      {
        "title": "Pavel Durov",
        "link": "https://yandex.com/search/?text=Pavel%20Durov&lr=10130&noreask=1&ento=0oCgpydXcxMjk3MzAyEhBydXcxNzUwMTE3OmFzc29jGAN6CFNlZSBhbHNv18M2fQ",
        "thumbnail": "https://avatars.mds.yandex.net/get-entity_search/2431491/979321994/S88x116Face_2x"
      },
      {
        "title": "Steve Jobs",
        "link": "https://yandex.com/search/?text=Steve%20Jobs&lr=10130&noreask=1&ento=0oCghydXc1NTk0NBIQcnV3MTc1MDExNzphc3NvYxgDeghTZWUgYWxzb4kxW3E",
        "thumbnail": "https://avatars.mds.yandex.net/get-entity_search/1245892/960653696/S88x116Face_2x"
      },
      ...
    ],
    "images": [
      {
        "source": {
          "name": "ptzgovorit.ru",
          "link": "https://ptzgovorit.ru/news/ilon-mask-razbogatel-na-desyat-milliardov-dollarov-za-nedelyu?page=1"
        },
        "original": {
          "link": "https://avatars.mds.yandex.net/get-entity_search/141303/784066096/S600xU_2x",
          "height": 1614,
          "width": 2616
        },
        "thumbnail": "https://avatars.mds.yandex.net/get-entity_search/141303/784066096/SUx182"
      },
      {
        "source": {
          "name": "bloomberg.com",
          "link": "https://www.bloomberg.com/news/newsletters/2024-04-17/tesla-s-strategy-shifts-are-following-elon-musk-s-ai-whims?cmpid=BBD041724_businessweek"
        },
        "original": {
          "link": "https://avatars.mds.yandex.net/get-entity_search/2304191/953684957/S600xU_2x",
          "height": 1333,
          "width": 2000
        },
        "thumbnail": "https://avatars.mds.yandex.net/get-entity_search/2304191/953684957/SUx182"
      },
      ...
    ]
  }
}

Ads

Ads
GET
https://www.searchapi.io/api/v1/search?engine=yandex&q=Buy+Car
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "yandex",
  "q": "Buy Car"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "ads": [
    {
      "position": 1,
      "title": "Инструкции к самому себе — 555 ₽",
      "tracking_link": "https://yabs.yandex.ru/count/...",
      "link": "https://t.me/Mettamorfosis_Bot?yclid=13638766871947247615",
      "domain": "t.me",
      "displayed_link": "t.me › Преображение…",
      "snippet": "В течении 600 дней ты будешь получать всю информацию о себе, а ещё узнаешь зачем..."
    },
    {
      "position": 2,
      "title": "Imports and exports from Russia",
      "tracking_link": "https://yabs.yandex.ru/count/...",
      "link": "https://gttllc.ru?yclid=13989000255667437567",
      "domain": "gttllc.ru",
      "displayed_link": "gttllc.ru › Imports and exports from Russia…",
      "snippet": "High standards of quality. Complete control over your shipments. Favorable prices.",
      "sitelinks": {
        "inline": [
          {
            "title": "Our services",
            "tracking_link": "https://yabs.yandex.ru/count/...",
            "link": "https://gttllc.ru/our-services/?yclid=13989000255667437567"
          },
          ...
        ]
      }
    }
  ]
}

Organic Results

Organic Results
GET
https://www.searchapi.io/api/v1/search?engine=yandex&q=ChatGPT
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "yandex",
  "q": "ChatGPT"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "organic_results": [
    {
      "position": 1,
      "title": "ChatGPT: 30 incredible ways to use the AI-powered chatbot",
      "link": "https://interestingengineering.com/lists/chatgpt-30-incredible-ways-to-use",
      "domain": "interestingengineering.com",
      "displayed_link": "interestingengineering.com › Lists",
      "snippet": "ChatGPT is an advanced language model developed by OpenAI.",
      "cached_page_link": "https://yandexwebcache.net/yandbtm?fmode=inject&tm=1723646561&tld=com&lang=en&la=1722929536&text=Chatgpt&url=https%3A//interestingengineering.com/lists/chatgpt-30-incredible-ways-to-use&l10n=en&mime=html&sign=8943c4f604025b900635416e951897eb&keyno=0"
    },
    {
      "position": 2,
      "title": "New York Times' sues ChatGPT creator OpenAI, Microsoft...",
      "link": "https://www.npr.org/2023/12/27/1221821750/new-york-times-sues-chatgpt-openai-microsoft-for-copyright-infringement",
      "domain": "www.npr.org",
      "displayed_link": "npr.org › 2023/12/27/1221821750/new-york-times-sues…",
      "snippet": "The New York Times sued OpenAI and its biggest backer, Microsoft, over copyright infringement on Wednesday, alleging the creator of ChatGPT used the..."
    },
    {
      "position": 3,
      "title": "Taxi & Limousine Commission",
      "link": "https://www.nyc.gov/site/tlc/index.page",
      "domain": "www.nyc.gov",
      "displayed_link": "nyc.gov › site/tlc/index.page",
      "snippet": "NYC Emergency Management has issued a travel advisory for Tuesday and Wednesday for heavy rainfall and potential flash flooding. Click to learn more.",
      "cached_page_link": "https://yandexwebcache.net/yandbtm?fmode=inject&tm=1723646561&tld=com&lang=en&la=1723132672&text=Chatgpt&url=https%3A//www.nyc.gov/site/tlc/index.page&l10n=en&mime=html&sign=abcba9831d6639e1b37482ef4fd0099b&keyno=0"
    },
    ...
  ]
}

Inline Images

Inline Images
GET
https://www.searchapi.io/api/v1/search?engine=yandex&q=Panda+images
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "yandex",
  "q": "Panda images"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "inline_images": [
    {
      "title": "Купить картина на холсте с подрамником ХитАрт Панда на",
      "original": {
        "link": "https://yandex.com/images/search?text=Panda+images&img_url=https%3A%2F%2Fs1.1zoom.ru%2Fbig3%2F34%2FPandas_Cubs_Trunk_tree_498655.jpg&pos=0&rpt=simage&stype=image&lr=89&parent-reqid=1727699969071121-2873694398464592972-balancer-l7leveler-kubr-yp-klg-175-BAL&source=serp",
        "height": 676,
        "width": 1024
      },
      "thumbnail": "https://avatars.mds.yandex.net/i?id=032a28de8b4ffde11f22083472a08081269e7e86-5293830-images-thumbs&n=13"
    },
    {
      "title": "Panda Meng Meng Im Berliner Zoo Panda bear, Giant panda,",
      "original": {
        "link": "https://yandex.com/images/search?text=Panda+images&img_url=https%3A%2F%2Fwww.zoo-berlin.de%2Ffileadmin%2F_processed_%2F3%2Fb%2Fcsm_Meng_Meng_Zoo_Berlin_2017_02657e9a94.jpg&pos=1&rpt=simage&stype=image&lr=89&parent-reqid=1727699969071121-2873694398464592972-balancer-l7leveler-kubr-yp-klg-175-BAL&source=serp",
        "height": 490,
        "width": 736
      },
      "thumbnail": "https://avatars.mds.yandex.net/i?id=b8856f476d502e575edd1406182892bc99bf89be-7675486-images-thumbs&n=13"
    },
    {
      "title": "nancymac - Animals",
      "original": {
        "link": "https://yandex.com/images/search?text=Panda+images&img_url=https%3A%2F%2Fjooinn.com%2Fimages%2Fgiant-panda-61.jpg&pos=2&rpt=simage&stype=image&lr=89&parent-reqid=1727699969071121-2873694398464592972-balancer-l7leveler-kubr-yp-klg-175-BAL&source=serp",
        "height": 768,
        "width": 1024
      },
      "thumbnail": "https://avatars.mds.yandex.net/i?id=44104fe6c70ade5f4f6eb1bab6b81727-4028342-images-thumbs&n=13"
    },
    ...
  ]
}

Inline Videos

Inline Videos
GET
https://www.searchapi.io/api/v1/search?engine=yandex&q=Minecraft+trailer
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "yandex",
  "q": "Minecraft trailer"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "inline_videos": [
    {
      "position": 1,
      "title": "Minecraft 1.22: Official Trailer (Pale Garden Update) Gameplay",
      "link": "https://yandex.com/video/preview/14392500618538908125?text=Minecraft%20trailer&path=yandex_search&parent-reqid=1727700177445439-6783577609966583889-balancer-l7leveler-kubr-yp-sas-141-BAL&from_type=vast",
      "source": "YouTube",
      "channel": "Minuthu",
      "duration": "1:21",
      "views": 57.8,
      "date": "28 Sep 2024",
      "image": "https://avatars.mds.yandex.net/get-video_thumb_fresh/1365014/72d4180e66257d83fd939d8e18273d550928/176x100"
    },
    {
      "position": 2,
      "title": "Minecraft Movie Trailer Comparison: Live Action VS Animated",
      "link": "https://yandex.com/video/preview/2984073181756253849?text=Minecraft%20trailer&path=yandex_search&parent-reqid=1727700177445439-6783577609966583889-balancer-l7leveler-kubr-yp-sas-141-BAL&from_type=vast",
      "source": "YouTube",
      "channel": "Aesthics",
      "duration": "1:11",
      "date": "29 Sep 2024",
      "image": "https://avatars.mds.yandex.net/get-video_thumb_fresh/2069176/3b012b38953945ec7be36bef6a2a30e70930/176x100"
    },
    ...
  ]
}