Запрашивает механизм ИИ-ответов для видимости в GEO/AEO.
Oxylabs
AI-assisted web search.
Запрашивает механизм ИИ-ответов для видимости в GEO/AEO.
Выполняет синхронный поиск с поддержкой ИИ, используя source google_search или google_ai_mode и другие документированные поля запроса. Этот эндпоинт не принимает chatgpt, gemini или perplexity в качестве синхронных источников.
Справочные цены
- Тарификация: фиксированная базовая стоимость успешного запроса.
- Справочная оценка запроса: USD 0.00145.
- Справочный множитель для клиента: 1.45. Не применяйте его повторно к уже рассчитанной сумме клиента.
Справочные метаданные, а не коммерческое предложение для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.
Сквозное тело запроса для ответных движков Google. source выбирает движок; query, render, parse и geo_location — параметры, которые ожидают источники Google. Дополнительные параметры вышестоящего сервиса передаются как есть.
- Тип: string enumsourceобязательно
Ответный движок Google AI для запроса.
google_searchвозвращает Google AI Overviews;google_ai_modeвозвращает Google AI Mode. Для ChatGPT/Gemini/Perplexity вместо этого используйте асинхронный эндпоинтpost_oxylabs_llm.значения- google
_search - google
_ai _mode
- Тип: stringgeo
_location Геолокация запроса на уровне страны, например "United States".
- Тип: booleanparse
Возвращает структурированные разобранные результаты вместо необработанного вывода. Рекомендуется для всех источников.
- Тип: stringquery
Поисковый запрос. Обязателен для
google_searchиgoogle_ai_mode. - enumrenderконстанта:html
Для
google_searchиgoogle_ai_modeустановите "html", чтобы отрисовать страницу перед разбором.значения- html
- Тип: anythingproperty
Name
- Тип: object200
Запрос успешно выполнен.
results[]содержит один результат на запрос. Разобранная структура внутриcontentзависит от источника (см. описания свойств); пример ниже показывает структуруgoogle_search(Google AI Overviews).- Тип: array object[]results
Одна запись на запрос. Одиночный запрос Realtime возвращает ровно один результат — это и есть тарифицируемая единица.
- contentТип: object
Разобранный ответный payload. Структура зависит от источника Google:
google_search→content.results.ai_overviews[];answer_textиreferences[]{source, url}(показано ниже).google_ai_mode→content.citations[]{text, urls[]}.
- resultsТип: object
Контейнер разобранных результатов типа Google.
- aiТип: array object[]
_overviews Google AI Overviews, возвращённые для запроса.
- answerТип: array object[]
_text Ответ, сгенерированный AI, разбитый на фрагменты, которые могут содержать встроенные ссылки.
- fragmentsТип: array object[]
- referencesТип: array
- referencesТип: array object[]
Источники, цитируемые в этом обзоре.
- sourceТип: string
- urlТип: string
application/json - 400
Запрос не удалось обработать. Проверьте параметры запроса.
- 401
Требуется действительный API-ключ Felo.
- 402
Запрос не может быть выполнен: не выполнено требование биллинга.
- 403
Аккаунту не разрешено выполнять эту операцию.
- 429
Достигнут лимит запросов или расходов.
- 502
Сервис не смог выполнить запрос.
- 503
API или сервис биллинга временно недоступны.
- 504
Истекло время ожидания обработки запроса.
- default
Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера
application/json
curl https://openapi.felo.ai/v1/beta/oxylabs/ai-search \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"source": "google_search",
"query": "best noise cancelling headphones 2026",
"parse": true,
"render": "html",
"geo_location": "United States"
}'
{
"results": [
{
"content": {
"results": {
"ai_overviews": [
{
"answer_text": [
{
"fragments": [
{
"references": "[Max Depth Exceeded]"
}
]
}
],
"references": [
{
"source": "string",
"url": "string"
}
]
}
]
}
}
}
]
}