DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
ردود Perplexity المباشرة عبر LLM Responses
يرسل user_prompt إلى نموذج Perplexity ويعيد رده بشكل متزامن. يجب أن يأتي model_name من get_dataforseo_ai_perplexity_llm_responses_models — sonar وsonar-pro وsonar-reasoning-pro. يحدّد web_search_country_iso_code نطاق البحث، وهو ما لا توفره المورّدات الثلاثة الأخرى. يعيد 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.
مرجع التسعير
- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 0.0163 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: array (object | null)[]
- maxالنوع: integer | null
_output _tokens الحد الأقصى لعدد الرموز في استجابة AI
حقل اختياري
الحد الأدنى:1
الحد الأقصى:4096؛
القيمة الافتراضية:2048؛
ملاحظة: إذا حُدد نموذج استدلال في الطلب، فقد يتجاوز عدد رموز الإخراج الحد المحدد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 اسم نموذج AI
حقل مطلوبmodel_nameيتكون من اسم النموذج الفعلي واسم الإصدار؛
إذا حُدد الاسم الأساسي للنموذج، فسيُعيّن أحدث إصدار له افتراضيًا؛
يمكنك الحصول على قائمة نماذج LLM المتاحة عبر طلب منفصل إلى نقطة النهاية التالية:https://api.dataforseo.com/v3/ai_optimization/perplexity/llm_responses/models - systemالنوع: string | null
_message تعليمات لسلوك الذكاء الاصطناعي
حقل اختياري
يحدد دور الذكاء الاصطناعي أو نبرته أو سلوكه المحدد
يمكنك تحديد حتى 500 حرف في حقلsystem_message - tagالنوع: string | null
معرّف مهمة يحدده المستخدم
حقل اختياري
الحد الأقصى للأحرف هو 255
يمكنك استخدام هذا المعامل لتمييز المهمة ومطابقتها مع النتيجة
ستجد قيمةtagالمحددة في كائنdataضمن الاستجابة - temperatureالنوع: number | null
عشوائية استجابة AI
حقل اختياري
القيم الأعلى تجعل الإخراج أكثر تنوعًا
القيم الأدنى تجعل الإخراج أكثر تركيزًا
الحد الأدنى:0
الحد الأقصى:1.9
القيمة الافتراضية:0.77 - topالنوع: number | null
_p تنوّع استجابة الذكاء الاصطناعي
حقل اختياري
يتحكم في تنوّع الاستجابة عبر تقييد اختيار الرموز
الحد الأدنى:0
الحد الأقصى:1
القيمة الافتراضية:0.9 - userالنوع: string
_prompt موجّه نموذج الذكاء الاصطناعي
حقل مطلوب
السؤال أو المهمة التي تريد إرسالها إلى نموذج الذكاء الاصطناعي;
يمكنك تحديد حتى 500 حرف في حقلuser_prompt - webالنوع: string | null
_search _country _iso _code رمز الدولة لتوطين البحث على الويب
حقل اختياري
حدد رمز ISO الخاص بالدولة للحصول على نتائج بحث ويب موطنة
ملاحظة: متاح فقط لنماذج Perplexity Sonar
مثال:US
- النوع: object | null · Response36Afe1097B20_AiOptimizationPerplexityLlmResponsesLiveResponseInfo200
- النوع: number | null التنسيق: doublecost
إجمالي تكلفة المهام، بالدولار الأمريكي
- النوع: integer | nullstatus
_code رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا
- النوع: string | nullstatus
_message رسالة معلوماتية عامة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا
- النوع: array (object | null)[] | nulltasks
مصفوفة المهام
- النوع: object | null · Response36Afe1097B20_AiOptimizationPerplexityLlmResponsesLiveTaskInfo
- 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النوع: object | null
_out _queries مصفوفة استعلامات التفرّع
تحتوي على استعلامات بحث ذات صلة مشتقة من الاستعلام الرئيسي لتقديم استجابة أكثر شمولًا - inputالنوع: integer | null
_tokens عدد الرموز في المدخلات
العدد الإجمالي للرموز المعالَجة - itemsالنوع: array (object | null)[] | null
مصفوفة عناصر الاستجابة
تحتوي على بيانات استجابة الذكاء الاصطناعي المهيكلة- النوع: object | null · Response36Afe1097B20_MessageAiOptimizationLlmResponseElementItem
- النوع: object · Response36Afe1097B20_MessageAiOptimizationLlmResponseElementItem
- typeالمميّزالنوع: string | null
نوع العنصر
- sectionsالنوع: array (object | null)[] | null
مقاطع سلسلة الاستدلال
مصفوفة كائنات تحتوي على مقاطع سلسلة الاستدلال التي يولّدها LLM- annotationsالنوع: array (object | null)[] | null
مصفوفة المراجع المستخدمة لإنشاء الاستجابة
تساويnullإذا لم يكن المعاملweb_searchمضبوطًا علىtrue
ملاحظة: قد يعيدannotationsنتيجة فارغة حتى عندما يكونweb_searchtrue، لأن الذكاء الاصطناعي سيحاول استرداد معلومات الويب لكنه قد لا يجد نتائج ذات صلة- directالنوع: string | null
_url عنوان URL مباشر للمصدر المقتبس
يحتوي على عنوان URL للمصدر الأصلي الذي تؤدي إليه إعادة توجيه Vertex AI في الحقلurl - endالنوع: integer | null
_index نهاية فهرسة التعليقات التوضيحية
- startالنوع: integer | null
_index بداية فهرسة التعليقات التوضيحية
- textالنوع: string | null
نص مقطع سلسلة الاستدلال
نص مقطع سلسلة الاستدلال الذي يلخّص عملية تفكير النموذج - titleالنوع: string | null
اسم نطاق المصدر المقتبس أو عنوانه
- urlالنوع: string | null
عنوان URL لإعادة التوجيه إلى المصدر المقتبس
يحتوي على إعادة توجيه من Vertex AI تؤدي إلى المصدر الأصلي
- textالنوع: string | null
نص مقطع سلسلة الاستدلال
نص مقطع سلسلة الاستدلال الذي يلخّص عملية تفكير النموذج - typeالنوع: string | null
نوع العنصر
- modelالنوع: string | null
_name اسم نموذج الذكاء الاصطناعي المستخدم
- moneyالنوع: number | null
_spent - outputالنوع: integer | null
_tokens عدد الرموز في المخرجات
العدد الإجمالي للرموز المولّدة في استجابة الذكاء الاصطناعي - reasoningالنوع: integer | null
_tokens Integer numbers.
- webالنوع: boolean | null
_search يشير إلى ما إذا كان البحث على الويب قد استُخدم
ملاحظة: البحث على الويب ممكّن افتراضيًا في نماذج Perplexity Sonar
- 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/perplexity/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,
"web_search_country_iso_code": "FR",
"model_name": "sonar",
"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": "[Max Depth Exceeded]",
"sections": "[Max Depth Exceeded]"
}
],
"fan_out_queries": null
}
]
}
]
}