DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
لائیو ChatGPT LLM Responses
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 صارف کے تجربے کو دوبارہ پیش کرتا ہے۔
قیمت کا حوالہ
- میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
- حوالہ جاتی درخواست کا تخمینہ: USD 0.0695۔
- حوالہ جاتی صارف ملٹی پلائر: 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 AI جواب میں ٹوکنز کی زیادہ سے زیادہ تعداد
اختیاری فیلڈ
reasoning ماڈلز کے لیے کم از کم قدر (مثلاً Models endpoint میںreasoningtrueہے):1024؛
غیر reasoning ماڈلز کے لیے کم از کم قدر:16؛
زیادہ سے زیادہ قدر:4096؛
ڈیفالٹ قدر:2048
نوٹ: اگرweb_searchtrueپر سیٹ ہو یا درخواست میں 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اصل ماڈل نام اور ورژن نام پر مشتمل ہوتا ہے؛
اگر بنیادی ماڈل نام متعین کیا جائے تو ڈیفالٹ طور پر اس کا تازہ ترین ورژن سیٹ ہو جائے گا؛
مثال کے طور پر اگر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 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_AiOptimizationChatGptLlmResponsesLiveResponseInfo200
- قسم: number | null فارمیٹ: doublecost
ٹاسکس کی کل لاگت، USD
- قسم: integer | nullstatus
_code عمومی اسٹیٹس کوڈ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے
- قسم: string | nullstatus
_message عمومی معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے
- قسم: array (object | null)[] | nulltasks
ٹاسکس کی صف
- قسم: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesLiveTaskInfo
- 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قسم: array (string | null)[] | null
_out _queries فین آؤٹ کوئریز کی صف
مرکزی کوئری سے اخذ کردہ متعلقہ تلاش کی کوئریز رکھتا ہے تاکہ زیادہ جامع جواب فراہم ہو - inputقسم: integer | null
_tokens ان پٹ میں ٹوکنز کی تعداد
کارروائی شدہ ٹوکنز کی کل تعداد - itemsقسم: array (object | null)[] | null
جوابی آئٹمز کی صف
ساختیافتہ AI جواب کا ڈیٹا رکھتا ہے- typeقسم: string | null
عنصر کی قسم
- modelقسم: string | null
_name استعمال شدہ AI ماڈل کا نام
- moneyقسم: number | null
_spent - outputقسم: integer | null
_tokens آؤٹ پٹ میں ٹوکنز کی تعداد
AI جواب میں تیار کردہ ٹوکنز کی کل تعداد - reasoningقسم: integer | null
_tokens reasoning ٹوکنز کی تعداد
reasoning مواد تیار کرنے کے لیے استعمال شدہ ٹوکنز کی کل تعداد - 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
درست 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/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
]
}
]
}
]
}