Oxylabs
AI-assisted web search.
AI 回答エンジンにクエリを送り、GEO/AEO の可視性を確認します。
source に google_search または google_ai_mode を指定し、記載された他のリクエストフィールドとともに、同期的な AI 支援検索を実行します。このエンドポイントは 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[]にはクエリごとに 1 件の結果が格納されます。content内の解析済みの形はソースによって異なります（各プロパティの説明を参照）。以下の例はgoogle_search（Google AI 概要）の形を示しています。- 型: array object[]results
クエリごとに 1 エントリ。Realtime の単一クエリは結果を 1 件だけ返し、その結果が課金単位です。
- content型: object
解析済みの回答ペイロード。構造は 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
有効な Felo API キーが必要です。
- 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"
}
]
}
]
}
}
}
]
}