# Запрашивает механизм ИИ-ответов для видимости в GEO/AEO.

**API:** Data API

**Endpoint:** `POST /v1/beta/oxylabs/ai-search`

**Tags:** Oxylabs

Выполняет синхронный поиск с поддержкой ИИ, используя source google_search или google_ai_mode и другие документированные поля запроса. Этот эндпоинт не принимает chatgpt, gemini или perplexity в качестве синхронных источников.

### Справочные цены

- Тарификация: фиксированная базовая стоимость успешного запроса.
- Справочная оценка запроса: USD 0.00145.
- Справочный множитель для клиента: 1.45. Не применяйте его повторно к уже рассчитанной сумме клиента.

Справочные метаданные, а не коммерческое предложение для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **yes**

### application/json

Schema:

```json
{
  "type": "object",
  "description": "Сквозное тело запроса для ответных движков Google. `source` выбирает движок; `query`, `render`, `parse` и `geo_location` — параметры, которые ожидают источники Google. Дополнительные параметры вышестоящего сервиса передаются как есть.",
  "additionalProperties": true,
  "properties": {
    "source": {
      "type": "string",
      "enum": [
        "google_search",
        "google_ai_mode"
      ],
      "description": "Ответный движок Google AI для запроса. `google_search` возвращает Google AI Overviews; `google_ai_mode` возвращает Google AI Mode. Для ChatGPT/Gemini/Perplexity вместо этого используйте асинхронный эндпоинт `post_oxylabs_llm`.",
      "example": "google_search"
    },
    "query": {
      "type": "string",
      "description": "Поисковый запрос. Обязателен для `google_search` и `google_ai_mode`.",
      "example": "best noise cancelling headphones 2026"
    },
    "render": {
      "type": "string",
      "enum": [
        "html"
      ],
      "description": "Для `google_search` и `google_ai_mode` установите \"html\", чтобы отрисовать страницу перед разбором.",
      "example": "html"
    },
    "parse": {
      "type": "boolean",
      "description": "Возвращает структурированные разобранные результаты вместо необработанного вывода. Рекомендуется для всех источников.",
      "example": true
    },
    "geo_location": {
      "type": "string",
      "description": "Геолокация запроса на уровне страны, например \"United States\".",
      "example": "United States"
    }
  },
  "required": [
    "source"
  ]
}
```

Example:

```json
{
  "source": "google_ai_mode",
  "query": "best noise cancelling headphones 2026",
  "parse": true,
  "render": "html",
  "geo_location": "United States"
}
```

## Responses

### 200 — Запрос успешно выполнен. `results[]` содержит один результат на запрос. Разобранная структура внутри `content` зависит от источника (см. описания свойств); пример ниже показывает структуру `google_search` (Google AI Overviews).

Headers:
- `X-Request-Id` (string) — Идентификатор запроса, который нужно указать при обращении в поддержку Felo.

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "description": "Одна запись на запрос. Одиночный запрос Realtime возвращает ровно один результат — это и есть тарифицируемая единица.",
      "items": {
        "type": "object",
        "properties": {
          "content": {
            "type": "object",
            "description": "Разобранный ответный payload. Структура зависит от источника Google:\n- `google_search` → `content.results.ai_overviews[]`; `answer_text` и `references[]{source, url}` (показано ниже).\n- `google_ai_mode` → `content.citations[]{text, urls[]}`.",
            "properties": {
              "results": {
                "type": "object",
                "description": "Контейнер разобранных результатов типа Google.",
                "properties": {
                  "ai_overviews": {
                    "type": "array",
                    "description": "Google AI Overviews, возвращённые для запроса.",
                    "items": {
                      "type": "object",
                      "properties": {
                        "answer_text": {
                          "type": "array",
                          "description": "Ответ, сгенерированный AI, разбитый на фрагменты, которые могут содержать встроенные ссылки.",
                          "items": {
                            "type": "object",
                            "properties": {
                              "fragments": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "references": {
                                      "type": "array",
                                      "items": {}
                                    }
                                  }
                                }
                              }
                            }
                          }
                        },
                        "references": {
                          "type": "array",
                          "description": "Источники, цитируемые в этом обзоре.",
                          "items": {
                            "type": "object",
                            "properties": {
                              "source": {
                                "type": "string"
                              },
                              "url": {
                                "type": "string"
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```

### 400 — Запрос не удалось обработать. Проверьте параметры запроса.

### 401 — Требуется действительный API-ключ Felo.

### 402 — Запрос не может быть выполнен: не выполнено требование биллинга.

### 403 — Аккаунту не разрешено выполнять эту операцию.

### 429 — Достигнут лимит запросов или расходов.

### 502 — Сервис не смог выполнить запрос.

### 503 — API или сервис биллинга временно недоступны.

### 504 — Истекло время ожидания обработки запроса.

### default — Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

**application/json**

Schema:

```json
{}
```