Yandex AI Overview API

GET   /api/v1/search?engine=yandex_ai_overview

Send a question to the yandex_ai_overview engine to receive a structured answer. Text answers include Markdown and text blocks. Additional result collections depend on the source answer.

An AI overview is returned when Yandex provides one for the query. The location parameter selects the search region. This engine does not support conversation continuation.

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    The question to send to Yandex AI Overview, up to 400 characters.

Localization

  • Name
    location
    Required
    Optional
    Description

    The Yandex region ID for the search. The default parameter is 213 (Moscow). Check the full list of supported Yandex locations.

Engine

  • Name
    engine
    Required
    Required
    Description

    Set to yandex_ai_overview.

API key

  • Name
    api_key
    Required
    Required
    Description

    Your SearchAPI API key. You can also use the Authorization: Bearer header.

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set to true to disable persistent storage and request logging.

Response

Response
GET
https://www.searchapi.io/api/v1/search?engine=yandex_ai_overview&q=%D0%BA%D0%B0%D0%BA+%D0%B2%D1%8B%D0%B1%D1%80%D0%B0%D1%82%D1%8C+%D0%BD%D0%BE%D1%83%D1%82%D0%B1%D1%83%D0%BA+%D0%B4%D0%BB%D1%8F+%D0%BF%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F+%D0%B8+%D0%B2%D0%B8%D0%B4%D0%B5%D0%BE%D0%BC%D0%BE%D0%BD%D1%82%D0%B0%D0%B6%D0%B0+%D0%B2+2026+%D0%B3%D0%BE%D0%B4%D1%83
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "yandex_ai_overview",
  "q": "как выбрать ноутбук для программирования и видеомонтажа в 2026 году"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_xRvzEGkNolVqF76Kpj4Q9WJb",
    "status": "Success",
    "created_at": "2026-11-05T17:06:12Z",
    "request_time_taken": 27.97,
    "parsing_time_taken": 0.01,
    "total_time_taken": 27.97,
    "request_url": "https://ya.ru/search/?text=%D0%BA%D0%B0%D0%BA+%D0%B2%D1%8B%D0%B1%D1%80%D0%B0%D1%82%D1%8C+%D0%BD%D0%B...",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_xRvzEGkNolVqF76Kpj4Q9WJb.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_xRvzEGkNolVqF76Kpj4Q9WJb"
  },
  "search_parameters": {
    "engine": "yandex_ai_overview",
    "q": "как выбрать ноутбук для программирования и видеомонтажа в 2026 году",
    "location": "213",
    "location_used": "Moscow"
  },
  "text_blocks": [
    {
      "type": "paragraph",
      "answer": "Выбор ноутбука для программирования и видеомонтажа в 2026 году требует баланса между производительностью, мобильностью и комфортом. Эти задачи сильно различаются, поэтому я рекомендую смотреть на ключевые характеристики отдельно, а затем искать модель, которая их объединит.",
      "reference_indexes": [
        0,
        ...
      ]
    },
    ...
  ],
  "markdown": "Выбор ноутбука для программирования и видеомонтажа в 2026 году требует баланса между производительностью, мобильностью и комфортом. Эти задачи сильно различаются, поэтому я рекомендую смотреть на ключевые характеристики отдельно, а затем искать модель, которая их объединит.\n\n## Программирование\n\nДля...",
  "reference_links": [
    {
      "index": 0,
      "title": "Ноутбук для программиста 2026 г: как выбрать идеальную машину для кода | Как выбрать ноутбук для программиста в 2026 году",
      "link": "https://www.xcom-shop.ru/news/noutbuk-dlya-programmista-2026-g-kak-vybrat-idealnuyu-mashinu-dlya-kod...",
      "source": "xcom-shop.ru",
      "snippet": "Ноутбук для программиста 2026 г: как выбрать идеальную машину для кода: Полное руководство по выбору ноутбука для программиста в 2026 году. Разбираем процессор,..."
    },
    ...
  ],
  "web_results": [
    {
      "position": 1,
      "title": "Лучшие ноутбуки для видеомонтажа 2026: рейтинг топ-20 лучших ноутбуков для видеомонтажа по версии КП с ценами, отзывами, фото и видео",
      "link": "https://www.kp.ru/expert/elektronika/luchshie-noutbuki-dlya-videomontazha/",
      "source": "kp.ru",
      "snippet": "Рейтинг топ-20 лучших ноутбуков для видеомонтажа в 2026 году с ценами, отзывами, фото и видео. Вместе с экспертом Олесей Кашицыной рассказываем, какой ноутбук д...",
      "breadcrumbs": [
        {
          "title": "kp.ru",
          "link": "https://kp.ru/"
        },
        ...
      ]
    },
    ...
  ],
  "related_questions": [
    {
      "question": "Какие дополнительные функции важны для ноутбука программиста?"
    },
    ...
  ],
  "search_queries": [
    "Критерии выбора ноутбука для видеомонтажа в 2026 году",
    ...
  ],
  "response_metadata": {
    "is_pharma_query": false
  }
}