یک موتور پاسخ هوش مصنوعی را برای دیده‌شدن در GEO/AEO پرس‌وجو کنید.
Oxylabs
AI-assisted web search.
یک موتور پاسخ هوش مصنوعی را برای دیده‌شدن در GEO/AEO پرس‌وجو کنید.
یک جستجوی همگام مبتنی بر هوش مصنوعی با source google_search یا google_ai_mode و سایر فیلدهای مستند درخواست اجرا کنید. این نقطه پایانی chatgpt، gemini یا perplexity را به‌عنوان منبع همگام نمی‌پذیرد.
مرجع قیمت‌گذاری
- اندازه‌گیری: مبنای هزینه ثابت برای درخواست موفق.
- برآورد درخواست مرجع: 0.00145 دلار آمریکا.
- ضریب مشتری مرجع: 1.45. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
بدنه passthrough برای موتورهای پاسخ 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
محموله پاسخ تجزیه‌شده. ساختار بسته به منبع 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 پاسخ تولیدشده با هوش مصنوعی، تقسیم‌شده به قطعاتی که ممکن است ارجاع‌های درون‌خطی داشته باشند.
- 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"
}
]
}
]
}
}
}
]
}