Truy vấn công cụ trả lời AI để đo khả năng hiển thị GEO/AEO.
Oxylabs
AI-assisted web search.
Truy vấn công cụ trả lời AI để đo khả năng hiển thị GEO/AEO.
Chạy tìm kiếm đồng bộ có AI hỗ trợ bằng source google_search hoặc google_ai_mode cùng các trường yêu cầu khác được ghi trong tài liệu. Endpoint này không chấp nhận chatgpt, gemini hay perplexity làm source đồng bộ.
Tham chiếu giá
- Đo lường: Cơ sở chi phí cố định theo yêu cầu thành công.
- Ước tính tham chiếu cho mỗi yêu cầu: USD 0.00145.
- Hệ số khách hàng tham chiếu: 1.45. Không áp dụng lại cho số tiền khách hàng đã quyết toán.
Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.
Body chuyển tiếp cho các công cụ trả lời của Google. source chọn công cụ; query, render, parse và geo_location là các tham số mà nguồn Google mong đợi. Các tham số upstream bổ sung được chuyển tiếp nguyên trạng.
- Kiểu: string enumsourcebắt buộc
Công cụ trả lời AI của Google cần truy vấn.
google_searchtrả về Google AI Overviews;google_ai_modetrả về Google AI Mode. Với ChatGPT/Gemini/Perplexity, hãy dùng endpoint bất đồng bộpost_oxylabs_llmthay thế.giá trị- google
_search - google
_ai _mode
- Kiểu: stringgeo
_location Vị trí địa lý cấp quốc gia cho truy vấn, ví dụ "United States".
- Kiểu: booleanparse
Trả về kết quả đã phân tích có cấu trúc thay vì đầu ra thô. Được khuyến nghị cho mọi nguồn.
- Kiểu: stringquery
Truy vấn tìm kiếm. Bắt buộc với
google_searchvàgoogle_ai_mode. - enumrenderconst:html
Với
google_searchvàgoogle_ai_mode, đặt thành "html" để render trang trước khi phân tích.giá trị- html
- Kiểu: anythingproperty
Name
- Kiểu: object200
Truy vấn hoàn tất thành công.
results[]chứa một kết quả cho mỗi truy vấn. Hình dạng đã phân tích trongcontentthay đổi theo source (xem mô tả thuộc tính); ví dụ bên dưới minh họa dạnggoogle_search(Google AI Overviews).- Kiểu: array object[]results
Mỗi truy vấn một mục. Một truy vấn Realtime đơn lẻ trả về đúng một kết quả, đây là đơn vị được tính phí.
- contentKiểu: object
Payload câu trả lời đã phân tích. Cấu trúc thay đổi theo nguồn Google:
google_search→content.results.ai_overviews[]vớianswer_textvàreferences[]{source, url}(hiển thị bên dưới).google_ai_mode→content.citations[]{text, urls[]}.
- resultsKiểu: object
Vùng chứa kết quả đã phân tích kiểu Google.
- aiKiểu: array object[]
_overviews Google AI Overviews được trả về cho truy vấn.
- answerKiểu: array object[]
_text Câu trả lời do AI tạo, được chia thành các đoạn có thể mang trích dẫn nội tuyến.
- fragmentsKiểu: array object[]
- referencesKiểu: array
- referencesKiểu: array object[]
Các nguồn được trích dẫn cho tổng quan này.
- sourceKiểu: string
- urlKiểu: string
application/json - 400
Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.
- 401
Cần có khóa API Felo hợp lệ.
- 402
Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.
- 403
Tài khoản không được phép thực hiện thao tác này.
- 429
Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.
- 502
Dịch vụ không thể hoàn tất yêu cầu.
- 503
API hoặc dịch vụ thanh toán tạm thời không khả dụng.
- 504
Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.
- default
Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp
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"
}
]
}
]
}
}
}
]
}