استعلم محرّك إجابات بالذكاء الاصطناعي لقياس الظهور في GEO/AEO.
Oxylabs
AI-assisted web search.
استعلم محرّك إجابات بالذكاء الاصطناعي لقياس الظهور في GEO/AEO.
نفّذ بحثًا متزامنًا بمساعدة الذكاء الاصطناعي باستخدام source google_search أو google_ai_mode وحقول الطلب الأخرى الموثّقة. لا تقبل نقطة النهاية هذه chatgpt أو gemini أو perplexity كمصادر متزامنة.
مرجع التسعير
- القياس: أساس تكلفة ثابت لكل طلب ناجح.
- تقدير الطلب المرجعي: 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[]نتيجة واحدة لكل استعلام. يختلف الشكل المُحلّل داخل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"
}
]
}
]
}
}
}
]
}