DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
‘LLM Responses ChatGPT’ ٹاسکس سیٹ کرنا
جواب کا انتظار کرنے کے بجائے ChatGPT پرامپٹ کو قطار میں ڈالتا ہے اور ٹاسک id واپس کرتا ہے۔ لائیو endpoint کے مقابلے system_message اور message_chain شامل کرتا ہے، تاکہ کثیر الجہتی گفتگو ایک ٹاسک میں بھیجی جا سکے۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا tasks[0].result میں، نتیجہ tasks[0].status_code میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔ ⚠️ ہر ماڈل قطار میں ڈالنا سپورٹ نہیں کرتا - get_dataforseo_ai_chat_gpt_llm_responses_models میں task_post_supported دیکھیں۔ get_dataforseo_ai_chat_gpt_llm_responses_fetch سے حاصل کریں۔
قیمت کا حوالہ
- میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
- حوالہ جاتی درخواست کا تخمینہ: USD 0.701۔
- حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔
صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔
- قسم: array (object | null)[]
- forceقسم: boolean | null
_web _search AI ایجنٹ کو ویب تلاش استعمال کرنے پر مجبور کریں
اختیاری فیلڈ
اس پیرامیٹر کو فعال کرنے کے لیےweb_searchبھی فعال ہونا چاہیے؛
فعال ہونے پر AI ماڈل موجودہ ویب معلومات تک رسائی اور ان کا حوالہ دینے پر مجبور ہوتا ہے؛
ڈیفالٹ قدر:false؛
نوٹ: پیرامیٹرtrueپر سیٹ ہونے کے باوجود اس بات کی کوئی ضمانت نہیں کہ جواب میں ویب ماخذ کا حوالہ دیا جائے گا
نوٹ #2: reasoning ماڈلز میں معاون نہیں - maxقسم: integer | null
_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اصل ماڈل نام اور ورژن نام پر مشتمل ہوتا ہے؛
اگر بنیادی ماڈل نام متعین کیا جائے تو ڈیفالٹ طور پر اس کا تازہ ترین ورژن سیٹ ہو جائے گا؛
مثال کے طور پر اگرgpt-4.1متعین کیا جائے توgpt-4.1-2025-04-14خود بخودmodel_nameکے طور پر سیٹ ہو جائے گا؛
آپ دستیاب LLM ماڈلز کی فہرستhttps://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/modelsپر الگ درخواست بھیج کر حاصل کر سکتے ہیں - pingbackقسم: string | null
_url مکمل شدہ ٹاسک کا نوٹیفکیشن URL
اختیاری فیلڈ
ٹاسک مکمل ہونے پر ہم آپ کو آپ کے متعین کردہ URL پر GET درخواست بھیج کر مطلع کریں گے
آپ ‘$id’ اسٹرنگ کو$idمتغیر کے طور پر اور ‘$tag’ کو urlencoded$tagمتغیر کے طور پر استعمال کر سکتے ہیں۔ ہم درخواست بھیجنے سے پہلے ضروری اقدار سیٹ کر دیں گے
مثال:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
نوٹ:pingback_urlمیں خصوصی حرف urlencoded ہو جائے گا؛
یعنی،#حرف%23میں انکوڈ ہو جائے گا - postbackقسم: string | null
_url ٹاسک کے نتائج بھیجنے کے لیے URL
اختیاری فیلڈ
ٹاسک مکمل ہونے کے بعد ہم اس کے نتائج کوgzipفارمیٹ میں کمپریس کر کے آپ کے متعین کردہpostback_urlپر POST درخواست کے ذریعے بھیجیں گے
آپ ‘$id’ اسٹرنگ کو$idمتغیر کے طور پر اور ‘$tag’ کو urlencoded$tagمتغیر کے طور پر استعمال کر سکتے ہیں۔ ہم درخواست بھیجنے سے پہلے ضروری اقدار سیٹ کر دیں گے۔
مثال:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
نوٹ:postback_urlمیں خصوصی حرف urlencoded ہو جائے گا؛
یعنی،#حرف%23میں انکوڈ ہو جائے گا - systemقسم: string | null
_message AI رویے کے لیے ہدایات
اختیاری فیلڈ
AI کا کردار، لہجہ یا مخصوص رویہ متعین کرتا ہے؛
آپsystem_messageفیلڈ میں زیادہ سے زیادہ 500 حروف متعین کر سکتے ہیں - tagقسم: string | null
صارف کے متعین کردہ ٹاسک کا شناخت کنندہ
اختیاری فیلڈ
حروف کی حد 255 ہے
آپ اس پیرامیٹر سے ٹاسک کی شناخت کر سکتے ہیں اور اسے نتیجے سے ملا سکتے ہیں
آپ جواب کےdataصف میں متعین کردہtagقدر دیکھیں گے - temperatureقسم: number | null
AI جواب کی تصادفی پن
اختیاری فیلڈ
زیادہ قدریں آؤٹ پٹ کو زیادہ متنوع بناتی ہیں؛
کم قدریں آؤٹ پٹ کو زیادہ مرکوز بناتی ہیں؛
کم از کم قدر:0
زیادہ سے زیادہ قدر:2
ڈیفالٹ قدر:0.94
نوٹ: reasoning ماڈلز میں معاون نہیں - topقسم: number | null
_p AI جواب کی تنوع
اختیاری فیلڈ
ٹوکن کے انتخاب کو محدود کر کے جواب کی تنوع کو کنٹرول کرتا ہے؛
کم از کم قدر:0
زیادہ سے زیادہ قدر:1
ڈیفالٹ قدر:0.92نوٹ:
top_pکو ایک ہی درخواست میںtemperatureکے ساتھ استعمال نہیں کیا جا سکتا - userقسم: string
_prompt AI ماڈل کے لیے پرامپٹ
درکار فیلڈ
وہ سوال یا کام جو آپ AI ماڈل کو بھیجنا چاہتے ہیں؛
آپuser_promptفیلڈ میں زیادہ سے زیادہ 500 حروف متعین کر سکتے ہیں - webقسم: boolean | null
_search - webقسم: string | null
_search _city مقام کے شہر کا نام
اختیاری فیلڈ
نوٹ:o3-mini،o1-pro،o1ماڈلز میں معاون نہیں - webقسم: string | null
_search _country _iso _code مقام کا ISO ملکی کوڈ
اختیاری فیلڈ
اس پیرامیٹر کو فعال کرنے کے لیےweb_searchبھی فعال ہونا چاہیے؛
فعال ہونے پر AI ماڈل آپ کے متعین کردہ ملک سے ویب تلاش کرے گا؛
نوٹ:o3-mini،o1-pro،o1ماڈلز میں معاون نہیں
- قسم: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesTaskPostResponseInfo200
- قسم: number | null فارمیٹ: doublecost
ٹاسکس کی کل لاگت، USD
- قسم: integer | nullstatus
_code عمومی اسٹیٹس کوڈ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے
- قسم: string | nullstatus
_message عمومی معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے
- قسم: array (object | null)[] | nulltasks
ٹاسکس کی صف
- قسم: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesTaskPostTaskInfo
- costقسم: number | null فارمیٹ: double
ٹاسکس کی کل لاگت، USD
- dataقسم: object | null
وہی پیرامیٹرز رکھتا ہے جو آپ نے POST درخواست میں متعین کیے۔
- propertyقسم: object | null
Name
- idقسم: string | null
ٹاسک شناخت کنندہ ہمارے نظام میں UUID فارمیٹ کا منفرد ٹاسک شناخت کنندہ
- pathقسم: array (string | null)[] | null
URL پاتھ
- resultقسم: object | null
نتائج کی صف
اس صورت میں قدرnullہوگی - 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/chat_gpt/llm_responses/task_post \
--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?"
}
],
"model_name": "gpt-4.1-mini",
"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": null
}
]
}