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 واپس کرتی ہے۔
قیمت کا حوالہ
- میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
- حوالہ جاتی درخواست کا تخمینہ: USD 0.0163۔
- حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔
صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔
- قسم: array (object | null)[]
- maxقسم: integer | null
_output _tokens AI جواب میں ٹوکنز کی زیادہ سے زیادہ تعداد
اختیاری فیلڈ
کم از کم قدر:1
زیادہ سے زیادہ قدر:4096؛
ڈیفالٹ قدر:2048؛
نوٹ: اگر درخواست میں reasoning ماڈل متعین ہو تو آؤٹ پٹ ٹوکن کی تعداد متعین کردہ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 ماڈلز کی فہرست درج ذیل endpoint پر الگ درخواست بھیج کر حاصل کر سکتے ہیں:https://api.dataforseo.com/v3/ai_optimization/perplexity/llm_responses/models - systemقسم: string | null
_message AI رویے کے لیے ہدایات
اختیاری فیلڈ
AI کا کردار، لہجہ یا مخصوص رویہ متعین کرتا ہے
آپsystem_messageفیلڈ میں زیادہ سے زیادہ 500 حروف متعین کر سکتے ہیں - tagقسم: string | null
صارف کے متعین کردہ ٹاسک کا شناخت کنندہ
اختیاری فیلڈ
حروف کی حد 255 ہے
آپ اس پیرامیٹر سے ٹاسک کی شناخت کر سکتے ہیں اور اسے نتیجے سے ملا سکتے ہیں
آپ جواب کےdataآبجیکٹ میں متعین کردہtagقدر دیکھیں گے - temperatureقسم: number | null
AI جواب کی تصادفی پن
اختیاری فیلڈ
زیادہ قدریں آؤٹ پٹ کو زیادہ متنوع بناتی ہیں
کم قدریں آؤٹ پٹ کو زیادہ مرکوز بناتی ہیں
کم از کم قدر:0
زیادہ سے زیادہ قدر:1.9
ڈیفالٹ قدر:0.77 - topقسم: number | null
_p AI جواب کی تنوع
اختیاری فیلڈ
ٹوکن کے انتخاب کو محدود کر کے جواب کی تنوع کو کنٹرول کرتا ہے
کم از کم قدر:0
زیادہ سے زیادہ قدر:1
ڈیفالٹ قدر:0.9 - userقسم: string
_prompt AI ماڈل کے لیے پرامپٹ
درکار فیلڈ
وہ سوال یا کام جو آپ AI ماڈل کو بھیجنا چاہتے ہیں؛
آپuser_promptفیلڈ میں زیادہ سے زیادہ 500 حروف متعین کر سکتے ہیں - webقسم: string | null
_search _country _iso _code ویب تلاش لوکلائزیشن کے لیے ملکی کوڈ
اختیاری فیلڈ
لوکلائزڈ ویب تلاش کے نتائج حاصل کرنے کے لیے ملک کا ISO کوڈ متعین کریں
نوٹ: صرف Perplexity Sonar ماڈلز کے لیے دستیاب
مثال:US
- قسم: object | null · Response36Afe1097B20_AiOptimizationPerplexityLlmResponsesLiveResponseInfo200
- قسم: number | null فارمیٹ: doublecost
ٹاسکس کی کل لاگت، USD
- قسم: integer | nullstatus
_code عمومی اسٹیٹس کوڈ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے
- قسم: string | nullstatus
_message عمومی معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے
- قسم: array (object | null)[] | nulltasks
ٹاسکس کی صف
- قسم: object | null · Response36Afe1097B20_AiOptimizationPerplexityLlmResponsesLiveTaskInfo
- costقسم: number | null فارمیٹ: double
ٹاسکس کی کل لاگت، USD
- 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
جوابی آئٹمز کی صف
ساختیافتہ AI جواب کا ڈیٹا رکھتا ہے- قسم: object | null · Response36Afe1097B20_MessageAiOptimizationLlmResponseElementItem
- قسم: object · Response36Afe1097B20_MessageAiOptimizationLlmResponseElementItem
- typeڈسکریمینیٹرقسم: string | null
عنصر کی قسم
- sectionsقسم: array (object | null)[] | null
reasoning chain سیکشنز
LLM کی جانب سے تیار کردہ reasoning chain سیکشنز پر مشتمل آبجیکٹس کی صف- annotationsقسم: array (object | null)[] | null
جواب تیار کرنے کے لیے استعمال ہونے والے حوالہ جات کی صف
nullکے برابر ہوتا ہے اگرweb_searchپیرامیٹرtrueپر سیٹ نہ ہو
نوٹ:annotationsخالی بھی واپس ہو سکتا ہے جبweb_searchtrueہو، کیونکہ AI ویب معلومات حاصل کرنے کی کوشش کرے گا مگر متعلقہ نتائج نہیں مل سکتے- directقسم: string | null
_url حوالہ دیے گئے ماخذ کا براہ راست URL
وہ اصل ماخذ URL شامل ہے جس تکurlفیلڈ میں موجود Vertex AI ری ڈائریکٹ لے جاتا ہے - endقسم: integer | null
_index اینوٹیشن انڈیکسنگ کا اختتام
- startقسم: integer | null
_index اینوٹیشن انڈیکسنگ کا آغاز
- textقسم: string | null
reasoning chain سیکشن کا متن
reasoning chain سیکشن کا متن جو ماڈل کے سوچنے کے عمل کا خلاصہ پیش کرتا ہے - titleقسم: string | null
حوالہ دیے گئے ماخذ کا ڈومین نام یا عنوان
- urlقسم: string | null
حوالہ دیے گئے ماخذ کا ری ڈائریکٹ URL
ایک Vertex AI ری ڈائریکٹ شامل ہے جو اصل ماخذ تک لے جاتا ہے
- textقسم: string | null
reasoning chain سیکشن کا متن
reasoning chain سیکشن کا متن جو ماڈل کے سوچنے کے عمل کا خلاصہ پیش کرتا ہے - typeقسم: string | null
عنصر کی قسم
- modelقسم: string | null
_name استعمال شدہ AI ماڈل کا نام
- moneyقسم: number | null
_spent - outputقسم: integer | null
_tokens آؤٹ پٹ میں ٹوکنز کی تعداد
AI جواب میں تیار کردہ ٹوکنز کی کل تعداد - 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
درست Felo API کلید درکار ہے۔
- 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
}
]
}
]
}