Oxylabs
AI-assisted web search.
שאילתת מנוע תשובות AI לנראות ב-GEO/AEO.
הרצת חיפוש סינכרוני בעזרת AI באמצעות source google_search או google_ai_mode ושאר שדות הבקשה המתועדים. נקודת קצה זו אינה מקבלת chatgpt, gemini או perplexity כמקורות סינכרוניים.
מראה תמחור
- מדידה: בסיס עלות קבוע לבקשה מוצלחת.
- אומדן בקשת ייחוס: 0.00145 דולר ארה״ב.
- מכפיל לקוח לייחוס: 1.45. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.
זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.
גוף passthrough למנועי התשובות של Google. source בוחר את המנוע; query, render, parse ו-geo_location הם הפרמטרים שמקורות Google מצפים להם. פרמטרים נוספים של ה-upstream מועברים כפי שהם.
- סוג: 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. - enumrenderconst:html
עבור
google_searchו-google_ai_mode, הגדירו "html" כדי לרנדר את העמוד לפני הפרסור.ערכים- html
- סוג: anythingproperty
Name
- סוג: object200
השאילתה הושלמה בהצלחה.
results[]מחזיק תוצאה אחת לכל שאילתה. הצורה המפוענחת בתוךcontentמשתנה לפי מקור (ראו תיאורי המאפיינים); הדוגמה שלמטה מציגה את צורתgoogle_search(Google AI Overviews).- סוג: array object[]results
רשומה אחת לכל שאילתה. שאילתה בודדת ב-Realtime מחזירה תוצאה אחת בדיוק, והיא יחידת החיוב.
- 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
נדרש מפתח 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"
}
]
}
]
}
}
}
]
}