DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
استجابات ChatGPT LLM المباشرة
يرسل user_prompt إلى نموذج ChatGPT ويعيد ردّه بشكل متزامن. يختار model_name النموذج — راجع get_dataforseo_ai_chat_gpt_llm_responses_models، ويُرفض الاسم غير المدرج مباشرة. يتصرف max_output_tokens وtemperature وtop_p كما في واجهة API الخاصة بالمزوّد، ويتيح web_search أو force_web_search التصفح. يعيد model_name وinput_tokens وoutput_tokens وreasoning_tokens وweb_search وmoney_spent وdatetime وitems وfan_out_queries. اقرأ money_spent في الاستجابة لمعرفة التكلفة الفعلية للطلب. مغلّفة في ظرف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — الطلب المرفوض يعيد HTTP 200 مع ذلك. ⚠️ هذا استدعاء LLM عام يتم توجيهه عبر مزوّد بيانات، وليس قياس SEO. إذا أردت معرفة ما يقوله ChatGPT للمستخدمين عن علامة تجارية، فإن post_dataforseo_ai_chat_gpt_llm_scraper_live يعيد إنتاج تجربة المستهلك بدلًا من ذلك.
مرجع التسعير
- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 0.0695 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. يجب عدم تطبيق مضاعفات المرجع مرة أخرى على مبالغ العملاء المسوّاة.
بيانات مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: array (object | null)[]
- forceالنوع: boolean | null
_web _search إجبار وكيل الذكاء الاصطناعي على استخدام البحث على الويب
حقل اختياري
لتفعيل هذا المعامل، يجب تفعيلweb_searchأيضًا;
عند التفعيل، يُلزَم نموذج الذكاء الاصطناعي بالوصول إلى معلومات الويب الحالية والاستشهاد بها;
القيمة الافتراضية:false;
ملاحظة: حتى إذا ضُبط المعامل علىtrue، فلا ضمان للاستشهاد بمصادر الويب في الاستجابة
ملاحظة 2: غير مدعوم في نماذج الاستدلال - maxالنوع: integer | null
_output _tokens الحد الأقصى لعدد الرموز في استجابة الذكاء الاصطناعي
حقل اختياري
الحد الأدنى لنماذج الاستدلال (مثلًا عندما تكونreasoningهيtrueفي نقطة نهاية Models):1024;
الحد الأدنى للنماذج غير الاستدلالية:16;
الحد الأقصى:4096;
القيمة الافتراضية:2048
ملاحظة: إذا ضُبطweb_searchعلىtrueأو حُدد نموذج استدلالي في الطلب، فقد يتجاوز عدد رموز الإخراج الحد المحدد فيmax_output_tokens - messageالنوع: array (object | null)[] | null
_chain تاريخ المحادثة حقل اختياري مصفوفة من كائنات الرسائل تمثل أدوار المحادثة السابقة; يجب أن يحتوي كل كائن على: سلسلة role بقيمة user أو ai; سلسلة message تحتوي على محتوى الرسالة (بحد أقصى 500 حرف); يمكنك تحديد 10 كائنات رسائل كحد أقصى في المصفوفة; ملاحظة: في نماذج Perplexity، يجب أن تتناوب الرسائل بدقة بين دوري user وai (user → ai); مثال: "message_chain": [{"role":"user","message":"Hello, what’s up?"},{"role":"ai","message":"Hello! I’m doing well, thank you. How can I assist you today?"}]
- messageالنوع: string | null
نص الرسالة
- roleالنوع: string | null
دور المستخدم الذي تصدر عنه الرسالة
- modelالنوع: string
_name اسم نموذج الذكاء الاصطناعي
حقل مطلوبmodel_nameيتكوّن من اسم النموذج الفعلي واسم الإصدار;
إذا حُدد اسم النموذج الأساسي، فسيُضبط أحدث إصدار له افتراضيًا;
مثلًا، إذا حُددgpt-4.1، فسيُضبطgpt-4.1-2025-04-14تلقائيًا كـmodel_name;
يمكنك الحصول على قائمة نماذج LLM المتاحة عبر إرسال طلب منفصل إلىhttps://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/models - systemالنوع: string | null
_message تعليمات لسلوك الذكاء الاصطناعي
حقل اختياري
يحدد دور الذكاء الاصطناعي أو نبرته أو سلوكه المحدد
يمكنك تحديد حتى 500 حرف في حقلsystem_message - tagالنوع: string | null
معرّف مهمة يحدده المستخدم
حقل اختياري
الحد الأقصى للأحرف هو 255
يمكنك استخدام هذا المعامل لتمييز المهمة ومطابقتها مع النتيجة
ستجد قيمةtagالمحددة في كائنdataضمن الاستجابة - temperatureالنوع: number | null
عشوائية استجابة الذكاء الاصطناعي
حقل اختياري
تزيد القيم الأعلى تنوّع المخرجات;
تجعل القيم الأدنى المخرجات أكثر تركيزًا;
الحد الأدنى:0
الحد الأقصى:2
القيمة الافتراضية:0.94
ملاحظة: غير مدعوم في نماذج الاستدلال - topالنوع: number | null
_p تنوّع استجابة الذكاء الاصطناعي
حقل اختياري
يتحكم في تنوّع الاستجابة عبر تقييد اختيار الرموز;
الحد الأدنى:0
الحد الأقصى:1
القيمة الافتراضية:0.92ملاحظة: لا يمكن استخدام
top_pمعtemperatureفي الطلب نفسه - userالنوع: string
_prompt موجّه نموذج الذكاء الاصطناعي
حقل مطلوب
السؤال أو المهمة التي تريد إرسالها إلى نموذج الذكاء الاصطناعي;
يمكنك تحديد حتى 500 حرف في حقلuser_prompt - webالنوع: boolean | null
_search - webالنوع: string | null
_search _city اسم مدينة الموقع
حقل اختياري
ملاحظة: غير مدعوم في نماذجo3-miniوo1-proوo1 - webالنوع: string | null
_search _country _iso _code رمز الدولة ISO للموقع
حقل اختياري
لتفعيل هذا المعامل، يجب تفعيلweb_searchأيضًا;
عند التفعيل، يبحث نموذج الذكاء الاصطناعي على الويب من الدولة التي تحددها;
ملاحظة: غير مدعوم في نماذجo3-miniوo1-proوo1
- النوع: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesLiveResponseInfo200
- النوع: number | null التنسيق: doublecost
إجمالي تكلفة المهام، بالدولار الأمريكي
- النوع: integer | nullstatus
_code رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا
- النوع: string | nullstatus
_message رسالة معلوماتية عامة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا
- النوع: array (object | null)[] | nulltasks
مصفوفة المهام
- النوع: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesLiveTaskInfo
- costالنوع: number | null التنسيق: double
إجمالي تكلفة المهام، بالدولار الأمريكي
- dataالنوع: object | null
يحتوي على المعاملات نفسها التي حددتها في طلب POST
- propertyالنوع: object | null
Name
- idالنوع: string | null
معرّف المهمة معرّف مهمة فريد في نظامنا بصيغة UUID
- pathالنوع: array (string | null)[] | null
مسار URL
- resultالنوع: array (object | null)[] | null
مصفوفة نتائج
- datetimeالنوع: string | null
التاريخ والوقت اللذان استُلمت فيهما النتيجة
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - fanالنوع: array (string | null)[] | null
_out _queries مصفوفة استعلامات التفرّع
تحتوي على استعلامات بحث ذات صلة مشتقة من الاستعلام الرئيسي لتقديم استجابة أكثر شمولًا - inputالنوع: integer | null
_tokens عدد الرموز في المدخلات
العدد الإجمالي للرموز المعالَجة - itemsالنوع: array (object | null)[] | null
مصفوفة عناصر الاستجابة
تحتوي على بيانات استجابة الذكاء الاصطناعي المهيكلة- typeالنوع: string | null
نوع العنصر
- modelالنوع: string | null
_name اسم نموذج الذكاء الاصطناعي المستخدم
- moneyالنوع: number | null
_spent - outputالنوع: integer | null
_tokens عدد الرموز في المخرجات
العدد الإجمالي للرموز المولّدة في استجابة الذكاء الاصطناعي - reasoningالنوع: integer | null
_tokens عدد رموز الاستدلال
العدد الإجمالي للرموز المستخدمة لإنشاء محتوى الاستدلال - webالنوع: boolean | null
_search يشير إلى ما إذا كان البحث على الويب قد استُخدم
- resultالنوع: integer | null التنسيق: int64
_count عدد العناصر في مصفوفة result
- statusالنوع: integer | null
_code رمز حالة المهمة ينشئه DataForSEO ويمكن أن يقع ضمن النطاق التالي: 10000-60000 يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا
- statusالنوع: string | null
_message الرسالة المعلوماتية للمهمة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا
- timeالنوع: string | null
وقت التنفيذ، بالثواني
- النوع: integer | null التنسيق: int64tasks
_count عدد المهام في مصفوفة tasks
- النوع: integer | null التنسيق: int64tasks
_error عدد المهام في مصفوفة tasks التي أُعيدت مع خطأ
- النوع: string | nulltime
إجمالي وقت التنفيذ، بالثواني
- النوع: string | nullversion
الإصدار الحالي من API
application/json - 400
تعذّرت معالجة الطلب. تحقق من معاملات الطلب.
- 401
مطلوب مفتاح API صالح من Felo.
- 402
لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.
- 403
الحساب غير مصرّح له بهذه العملية.
- 429
تم بلوغ حد الطلبات أو حد الإنفاق.
- 502
تعذّر على الخدمة إكمال الطلب.
- 503
خدمة API أو الفوترة غير متاحة مؤقتًا.
- 504
انتهت مهلة الخدمة أثناء معالجة الطلب.
- default
استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/chat_gpt/llm_responses/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"system_message": "communicate as if we are in a business meeting",
"message_chain": [
{
"role": "user",
"message": "Hello, what’s up?"
},
{
"role": "ai",
"message": "Hello! I’m doing well, thank you. How can I assist you today? Are there any specific topics or projects you’d like to discuss in our meeting?"
}
],
"max_output_tokens": 200,
"temperature": 0.3,
"top_p": 0.5,
"model_name": "gpt-4.1-mini",
"web_search": true,
"web_search_country_iso_code": "FR",
"web_search_city": "Paris",
"user_prompt": "provide information on how relevant the amusement park business is in France now"
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"model_name": null,
"input_tokens": null,
"output_tokens": null,
"reasoning_tokens": null,
"web_search": null,
"money_spent": null,
"datetime": null,
"items": [
{
"type": null
}
],
"fan_out_queries": [
null
]
}
]
}
]
}