Kueri mesin jawaban AI untuk visibilitas GEO/AEO.
Oxylabs
AI-assisted web search.
Kueri mesin jawaban AI untuk visibilitas GEO/AEO.
Jalankan pencarian sinkron berbantuan AI menggunakan source google_search atau google_ai_mode dan field permintaan lain yang didokumentasikan. Endpoint ini tidak menerima chatgpt, gemini, atau perplexity sebagai source sinkron.
Referensi harga
- Metering: Dasar biaya tetap per permintaan berhasil.
- Estimasi referensi per permintaan: USD 0.00145.
- Pengali pelanggan referensi: 1.45. Jangan terapkan lagi pada jumlah pelanggan yang telah diselesaikan.
Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.
Body passthrough untuk mesin jawaban Google. source memilih mesin; query, render, parse, dan geo_location adalah parameter yang diharapkan sumber Google. Parameter upstream tambahan diteruskan apa adanya.
- Tipe: string enumsourcewajib
Mesin jawaban AI Google yang akan dikueri.
google_searchmengembalikan Google AI Overviews;google_ai_modemengembalikan Google AI Mode. Untuk ChatGPT/Gemini/Perplexity gunakan endpoint asinkronpost_oxylabs_llmsebagai gantinya.nilai- google
_search - google
_ai _mode
- Tipe: stringgeo
_location Geo-lokasi tingkat negara untuk kueri, misalnya "United States".
- Tipe: booleanparse
Mengembalikan hasil terstruktur yang telah diurai, bukan output mentah. Direkomendasikan untuk setiap sumber.
- Tipe: stringquery
Kueri pencarian. Wajib untuk
google_searchdangoogle_ai_mode. - enumrenderconst:html
Untuk
google_searchdangoogle_ai_mode, setel ke "html" untuk merender halaman sebelum mengurai.nilai- html
- Tipe: anythingproperty
Name
- Tipe: object200
Kueri berhasil.
results[]berisi satu hasil per kueri. Bentuk terurai di dalamcontentberbeda menurut source (lihat deskripsi properti); contoh di bawah menunjukkan bentukgoogle_search(Google AI Overviews).- Tipe: array object[]results
Satu entri per kueri. Satu kueri Realtime mengembalikan tepat satu hasil, yang merupakan unit yang ditagih.
- contentTipe: object
Payload jawaban hasil parsing. Struktur bervariasi menurut sumber Google:
google_search→content.results.ai_overviews[]dengananswer_textdanreferences[]{source, url}(ditampilkan di bawah).google_ai_mode→content.citations[]{text, urls[]}.
- resultsTipe: object
Wadah hasil parsing bertipe Google.
- aiTipe: array object[]
_overviews Google AI Overviews yang dikembalikan untuk kueri.
- answerTipe: array object[]
_text Jawaban yang dihasilkan AI, dipecah menjadi fragmen yang mungkin membawa referensi inline.
- fragmentsTipe: array object[]
- referencesTipe: array
- referencesTipe: array object[]
Sumber yang dikutip untuk ikhtisar ini.
- sourceTipe: string
- urlTipe: string
application/json - 400
Permintaan tidak dapat diproses. Periksa parameter permintaan.
- 401
Kunci API Felo yang valid diperlukan.
- 402
Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.
- 403
Akun tidak diizinkan melakukan operasi ini.
- 429
Batas permintaan atau batas pengeluaran telah tercapai.
- 502
Layanan tidak dapat menyelesaikan permintaan.
- 503
API atau layanan penagihan untuk sementara tidak tersedia.
- 504
Layanan kehabisan waktu saat memproses permintaan.
- default
Respons error; respons passthrough upstream dapat menggunakan format penyedia
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"
}
]
}
]
}
}
}
]
}