Запитує механізм ШІ-відповідей для видимості в 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 перелікsourceобов'язкове
Механізм відповідей 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. - перелікrenderконстанта: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
Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника
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"
}
]
}
]
}
}
}
]
}