DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
لائیو LLM Mentions
وہ انفرادی جوابات جن میں کسی اسسٹنٹ نے آپ کے ہدف کا ذکر کیا۔ total_count، current_offset، search_after_token اور items واپس کرتا ہے - پہلے صفحات کے بعد offset کے بجائے token سے صفحہ بدلیں۔ ⚠️ target آبجیکٹس کی صف ہے، ہر ایک {"domain": "..."} یا {"keyword": "..."}؛ اکیلی string غلط قسم کے طور پر مسترد ہوتی ہے اور strings کی صف 'Each target item must be an object' کے ساتھ۔ فلٹر فیلڈز get_dataforseo_ai_llm_mentions_available_filters سے آتے ہیں۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا tasks[0].result میں، نتیجہ tasks[0].status_code میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔ گنتی کے لیے، خود mentions کے بجائے، post_dataforseo_ai_llm_mentions_aggregated_metrics_live استعمال کریں۔
قیمت کا حوالہ
- میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
- حوالہ جاتی درخواست کا تخمینہ: USD 0.701۔
- حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔
صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔
- قسم: array object[]
- targetقسم: array object[]لازمی
ہدف اداروں پر مشتمل آبجیکٹس کی صف۔ درکار فیلڈ۔ آپ target فیلڈ میں زیادہ سے زیادہ 10 ادارے (آبجیکٹس) متعین کر سکتے ہیں۔ ایک ہدف ادارہ یا تو ایک ڈومین یا ایک کی ورڈ اور متعلقہ پیرامیٹرز رکھ سکتا ہے۔ مثالیں: ڈومین ادارے کے ساتھ target صف [{"domain": "en.wikipedia.org", "search_filter": "exclude"}] کی ورڈ ادارے کے ساتھ target صف [{"keyword": "bmw", "search_scope": ["question"], "match_type ": "partial_match"}] متعدد اداروں کے ساتھ target صف [{"domain": "en.wikipedia.org", "search_filter": "exclude"}, {"keyword": "bmw", "match_type ": "partial_match", "search_scope": ["answer"]}]
- domainقسم: stringلازمی
ہدف ڈومین۔ اگر آپ keyword متعین نہ کریں تو درکار فیلڈ۔ آپ domain فیلڈ میں زیادہ سے زیادہ 63 حروف متعین کر سکتے ہیں؛ ڈومین https:// اور www. کے بغیر متعین کرنا چاہیے۔
- includeقسم: boolean
_subdomains بتاتا ہے کہ ہدف ڈومین کے ذیلی ڈومینز تلاش میں شامل ہوں گے یا نہیں۔ اختیاری فیلڈ۔ اگر true پر سیٹ ہو تو ذیلی ڈومینز تلاش میں شامل ہو جائیں گے۔ ڈیفالٹ قدر: false
- keywordقسم: string
ہدف کی ورڈ۔ اگر آپ domain متعین نہ کریں تو درکار فیلڈ۔ آپ keyword فیلڈ میں زیادہ سے زیادہ 250 حروف متعین کر سکتے ہیں تمام %## ڈی کوڈ ہوں گے (نیز ‘+’ حرف خالی جگہ کے حرف میں ڈی کوڈ ہوگا) اگر آپ کو اپنے keyword کے لیے “%” حرف استعمال کرنا ہو تو اسے “%25” کے طور پر متعین کریں؛ اگر آپ کو اپنے keyword کے لیے “+” حرف استعمال کرنا ہو تو اسے “%2B” کے طور پر متعین کریں DataForSEO APIs میں keyword اور keywords فیلڈز کے قواعد اور پابندیوں کے بارے میں اس Help Center مضمون میں مزید جانیں
- matchقسم: string
_type ہدف کی ورڈ کی مطابقت کی قسم۔ یہ متعین کرتی ہے کہ مخصوص کی ورڈ کیسے میچ کیا جاتا ہے۔ اختیاری فیلڈ۔ ممکنہ اقدار: word_match - مخصوص بیج کی ورڈ سے مطابقت رکھنے والی اصطلاحات کے لیے مکمل متن کی تلاش جس میں کلیدی فقرے سے پہلے، بعد یا اندر اضافی الفاظ شامل ہوں (مثلاً “light” تلاش کرنے پر “light bulb”، “light switch” والے نتائج آئیں گے)؛ partial_match - سب اسٹرنگ تلاش جو مخصوص حروف کی ترتیب رکھنے والے تمام واقعات تلاش کرتی ہے، چاہے وہ کسی طویل لفظ کے اندر ہی کیوں نہ ہوں (مثلاً “light” تلاش کرنے پر “lighting”، “highlight” والے نتائج آئیں گے)؛ ڈیفالٹ قدر: word_match
- searchقسم: string
_filter ادارہ تلاش فلٹر: include یا exclude؛ ڈیفالٹ include ہے۔
- searchقسم: array string[]
_scope تلاش کا دائرہ کار۔ ڈومین ادارے: any، sources، search_results۔ کی ورڈ ادارے: any، question، answer، brand_entities، fan_out_queries۔ ڈیفالٹ: any۔
- filtersقسم: array
نتائج کی فلٹرنگ پیرامیٹرز کی صف۔ اختیاری فیلڈ۔ آپ ایک ساتھ کئی فلٹرز شامل کر سکتے ہیں (زیادہ سے زیادہ 8 فلٹرز)۔ شرائط کے درمیان آپ کو منطقی آپریٹر and یا or سیٹ کرنا چاہیے۔ درج ذیل آپریٹرز معاون ہیں: =, , in, not_in, like, not_like, ilike, not_ilike, match, not_match۔ آپ صفر یا زیادہ حروف کی کسی بھی اسٹرنگ سے مطابقت کے لیے like اور not_like کے ساتھ % آپریٹر استعمال کر سکتے ہیں۔ مثال: ["ai_search_volume",">","1000"] ممکنہ فلٹرز کی مکمل فہرست یہاں دستیاب ہے۔
- languageقسم: string
_code تلاش کی زبان کا کوڈ۔ اختیاری فیلڈ۔ اگر آپ یہ فیلڈ استعمال کریں تو language_name متعین کرنے کی ضرورت نہیں؛ آپ سرچ انجن کی دستیاب زبانوں کی فہرست ان کے language_code کے ساتھ https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں۔ ڈیفالٹ قدر: en۔ نوٹ: chat_gpt ڈیٹا صرف en کے لیے دستیاب ہے
- languageقسم: string
_name تلاش کی زبان کا پورا نام۔ اختیاری فیلڈ۔ اگر آپ یہ فیلڈ استعمال کریں تو language_code متعین کرنے کی ضرورت نہیں؛ اگر آپ یہ فیلڈ متعین نہ کریں تو ڈیفالٹ طور پر en قدر والا language_code استعمال ہوگا؛ آپ سرچ انجن کی دستیاب زبانوں کی فہرست ان کے language_name کے ساتھ https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں۔ نوٹ: chat_gpt ڈیٹا صرف انگریزی کے لیے دستیاب ہے
- limitقسم: integer
واپس کیے جانے والے آبجیکٹس کی زیادہ سے زیادہ تعداد۔ اختیاری فیلڈ۔ ڈیفالٹ قدر: 100۔ زیادہ سے زیادہ قدر: 1000
- locationقسم: integer
_code تلاش کے مقام کا کوڈ۔ اختیاری فیلڈ۔ اگر آپ یہ فیلڈ استعمال کریں تو location_name متعین کرنے کی ضرورت نہیں۔ آپ سرچ انجن کے دستیاب مقامات کی فہرست ان کے location_code کے ساتھ https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں۔ ڈیفالٹ قدر: 2840۔ نوٹ: chat_gpt ڈیٹا صرف 2840 کے لیے دستیاب ہے
- locationقسم: string
_name تلاش کے مقام کا پورا نام۔ اختیاری فیلڈ۔ اگر آپ یہ فیلڈ استعمال کریں تو location_code متعین کرنے کی ضرورت نہیں۔ اگر آپ یہ فیلڈ متعین نہ کریں تو ڈیفالٹ طور پر 2840 قدر والا location_code استعمال ہوگا؛ آپ سرچ انجن کے دستیاب مقامات کی فہرست ان کے location_name کے ساتھ https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں۔ نوٹ: chat_gpt ڈیٹا صرف United States کے لیے دستیاب ہے
- offsetقسم: integer
واپس کیے جانے والے mentions ڈیٹا کی نتائج صف میں آفسیٹ۔ اختیاری فیلڈ۔ ڈیفالٹ قدر: 0۔ مثال: اگر آپ قدر 10 متعین کریں تو نتائج کی صف میں پہلے دس mentions آبجیکٹ چھوڑ دیے جائیں گے اور ڈیٹا اگلے آبجیکٹس کے لیے فراہم کیا جائے گا؛ نوٹ: زیادہ سے زیادہ قدر 9,000 ہے، اگر آپ مزید نتائج آفسیٹ کرنا چاہیں تو search_after_token استعمال کریں
- orderقسم: array string[]
_by نتائج کی ترتیب کے قواعد۔ اختیاری فیلڈ۔ آپ نتائج کی ترتیب کے لیے filters صف کی طرح وہی اقدار استعمال کر سکتے ہیں۔ ممکنہ ترتیب کی اقسام: asc - نتائج صعودی ترتیب میں ترتیب دیے جائیں گے؛ desc - نتائج نزولی ترتیب میں ترتیب دیے جائیں گے۔ ترتیب کی قسم مقرر کرنے کے لیے کوما استعمال کریں۔ مثال: ["ai_search_volume,desc"] نوٹ کریں کہ ایک ہی درخواست میں زیادہ سے زیادہ تین ترتیب کے قواعد مقرر کیے جا سکتے ہیں۔ کئی ترتیب کے قواعد کو الگ کرنے کے لیے کوما استعمال کریں
- platformقسم: string
ہدف پلیٹ فارم۔ اختیاری فیلڈ۔ ممکنہ اقدار: chat_gpt, google۔ ڈیفالٹ قدر: google۔ نوٹ: واپس ہونے والا ڈیٹا منتخب کردہ پلیٹ فارم پر منحصر ہے۔ نوٹ #2: chat_gpt ڈیٹا صرف United States اور انگریزی کے لیے دستیاب ہے
- searchقسم: string
_after _token بعد کی درخواستوں کے لیے ٹوکن۔ اختیاری فیلڈ۔ ہر درخواست کے جواب کے اسی فیلڈ میں فراہم کیا جاتا ہے؛ ایک ہی درخواست میں 20,000 سے زیادہ نتائج حاصل کرتے وقت ٹائم آؤٹ سے بچنے کے لیے یہ پیرامیٹر استعمال کریں؛ جواب کی صف سے منفرد search_after_token قدر متعین کر کے آپ کو ابتدائی ٹاسک کے بعد کے نتائج ملیں گے؛ search_after_token اقدار ہر بعد کے ٹاسک کے لیے منفرد ہوتی ہیں؛ نوٹ: اگر درخواست میں search_after_token متعین ہو تو دیگر تمام پیرامیٹرز پچھلی درخواست کے عین مطابق ہونے چاہئیں
- tagقسم: string
صارف کے متعین کردہ ٹاسک کا شناخت کنندہ۔ اختیاری فیلڈ۔ حروف کی حد 255 ہے۔ آپ اس پیرامیٹر سے ٹاسک کی شناخت کر سکتے ہیں اور اسے نتیجے سے ملا سکتے ہیں۔ آپ جواب کے data آبجیکٹ میں متعین کردہ tag قدر دیکھیں گے
- قسم: object200
کامیاب جواب
- قسم: numbercost
ٹاسکس کی کل لاگت، USD
- قسم: integerstatus
_code عمومی اسٹیٹس کوڈ۔ جوابی کوڈز کی مکمل فہرست یہاں مل سکتی ہے۔ نوٹ: ہم متعلقہ استثنائی یا خرابی کی صورتحال سنبھالنے کے لیے ضروری نظام ڈیزائن کرنے کی سختی سے سفارش کرتے ہیں
- قسم: stringstatus
_message عمومی معلوماتی پیغام۔ عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے
- قسم: array string[]tasks
ٹاسکس کی صف
- قسم: integertasks
_count tasks صف میں ٹاسکس کی تعداد
- قسم: integertasks
_error خرابی کے ساتھ واپس ہونے والے tasks صف میں ٹاسکس کی تعداد
- قسم: numbertasks
.cost ٹاسک کی لاگت، USD
- قسم: objecttasks
.data وہی پیرامیٹرز رکھتا ہے جو آپ نے POST درخواست میں متعین کیے۔
- قسم: stringtasks
.id ٹاسک کا شناخت کنندہ۔ ہمارے سسٹم میں UUID فارمیٹ میں منفرد ٹاسک شناخت کنندہ
- قسم: array string[]tasks
.path URL پاتھ
- قسم: array string[]tasks
.result نتائج کی صف
- قسم: integertasks
.result _count result صف میں عناصر کی تعداد
- قسم: integertasks
.result .current _offset items صف میں چھوڑے گئے mentions آبجیکٹس کی تعداد
- قسم: array string[]tasks
.result .items متعلقہ mentions کا ڈیٹا رکھتا ہے
- قسم: integertasks
.result .items _count items صف میں واپس کیے گئے نتائج کی تعداد
- قسم: integertasks
.result .items .ai _search _volume کسی کی ورڈ کی موجودہ AI سرچ والیوم کی مقدار۔ اس میٹرک کے بارے میں یہاں مزید جانیں
- قسم: stringtasks
.result .items .answer مارک ڈاؤن فارمیٹ میں متعلقہ جواب۔ مارک ڈاؤن مارک اپ زبان میں فارمیٹ شدہ نتیجے کا مواد
- قسم: array string[]tasks
.result .items .brand _entities brand entities کی صف۔ جواب میں ذکر شدہ برانڈز کی معلومات رکھتی ہے
- قسم: stringtasks
.result .items .brand _entities .category برانڈ کا زمرہ
- قسم: integertasks
.result .items .brand _entities .position نتائج میں پوزیشن
- قسم: stringtasks
.result .items .brand _entities .title برانڈ کا نام
- قسم: array string[]tasks
.result .items .fan _out _queries fan-out کوئریز کی صف۔ زیادہ جامع جواب فراہم کرنے کے لیے مرکزی کوئری سے ماخوذ متعلقہ تلاش کی کوئریز رکھتی ہے
- قسم: stringtasks
.result .items .first _response _at تاریخ اور وقت جب جواب کا ڈیٹا پہلی بار ریکارڈ ہوا، UTC فارمیٹ میں: “yyyy-mm-dd hh-mm-ss +00:00”۔ مثال: 2025-10-21 06:25:30 +00:00
- قسم: stringtasks
.result .items .language _code POST صف میں زبان کا کوڈ
- قسم: stringtasks
.result .items .last _response _at تاریخ اور وقت جب جواب کا ڈیٹا آخری بار اپ ڈیٹ ہوا، UTC فارمیٹ میں: “yyyy-mm-dd hh-mm-ss +00:00”۔ مثال: 2025-10-21 06:25:30 +00:00
- قسم: integertasks
.result .items .location _code POST صف میں مقام کا کوڈ
- قسم: stringtasks
.result .items .model _name AI ماڈل کا نام جس سے ڈیٹا حاصل کیا گیا۔ نوٹ: google پلیٹ فارم ٹائپ کے لیے قدر ہمیشہ google_ai_overview ہوتی ہے
- قسم: array string[]tasks
.result .items .monthly _searches ماہانہ AI سرچ والیوم کی مقداریں۔ سال کے کسی مخصوص مہینے میں AI سرچ والیوم کی مقداروں والے آبجیکٹس کی صف
- قسم: integertasks
.result .items .monthly _searches .month مہینہ
- قسم: integertasks
.result .items .monthly _searches .search _volume سال کے کسی مخصوص مہینے میں AI سرچ والیوم کی مقدار۔ اس میٹرک کے بارے میں یہاں مزید جانیں
- قسم: integertasks
.result .items .monthly _searches .year سال
- قسم: stringtasks
.result .items .platform POST صف میں موصول ہونے والا پلیٹ فارم
- قسم: stringtasks
.result .items .question متعلقہ سوال
- قسم: array string[]tasks
.result .items .search _results تلاش کے نتائج کی صف۔ وہ تمام ویب تلاش آؤٹ پٹس جو ماڈل نے معلومات تلاش کرتے وقت حاصل کیے، بشمول نقول اور غیر استعمال شدہ اندراجات
- قسم: string
بریڈکرمب
- قسم: stringtasks
.result .items .search _results .description نتیجے کی تفصیل
- قسم: stringtasks
.result .items .search _results .domain نتیجے کا ڈومین
- قسم: integertasks
.result .items .search _results .position نتائج میں پوزیشن
- قسم: stringtasks
.result .items .search _results .publication _date تاریخ اور وقت جب نتیجہ شائع ہوا، فارمیٹ: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”۔ مثال: 2019-11-15 12:57:46 +00:00
- قسم: stringtasks
.result .items .search _results .title نتیجے کا عنوان
- قسم: stringtasks
.result .items .search _results .url نتیجے کا URL
- قسم: array string[]tasks
.result .items .sources ماخذوں کی صف۔ وہ ماخذ جن کا ماڈل نے اپنے حتمی جواب میں حوالہ دیا یا جن پر انحصار کیا
- قسم: stringtasks
.result .items .sources .domain ماخذ ڈومین
- قسم: stringtasks
.result .items .sources .markdown عنصر کا مواد مارک ڈاؤن فارمیٹ میں۔ مارک ڈاؤن مارک اپ زبان میں فارمیٹ شدہ نتیجے کا مواد
- قسم: integertasks
.result .items .sources .position نتائج میں پوزیشن
- قسم: stringtasks
.result .items .sources .publication _date تاریخ اور وقت جب نتیجہ شائع ہوا، فارمیٹ: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”۔ مثال: 2019-11-15 12:57:46 +00:00
- قسم: stringtasks
.result .items .sources .snippet ماخذ کی تفصیل
- قسم: stringtasks
.result .items .sources .source _name ماخذ کا نام
- قسم: stringtasks
.result .items .sources .thumbnail ماخذ کا تھمب نیل
- قسم: stringtasks
.result .items .sources .title ماخذ کا عنوان
- قسم: stringtasks
.result .items .sources .url ماخذ کا URL
- قسم: stringtasks
.result .search _after _token بعد کی درخواستوں کے لیے ٹوکن۔ نیا ٹاسک سیٹ کرتے وقت منفرد search_after_token متعین کر کے آپ کو ابتدائی ٹاسک کے بعد کے نتائج ملیں گے؛ search_after_token اقدار ہر بعد کے ٹاسک کے لیے منفرد ہوتی ہیں
- قسم: integertasks
.result .total _count درخواست سے متعلقہ نتائج کی کل تعداد
- قسم: integertasks
.status _code DataForSEO کی جانب سے بنائے گئے ٹاسک کا اسٹیٹس کوڈ؛ درج ذیل رینج میں ہو سکتا ہے: 10000-60000۔ جوابی کوڈز کی مکمل فہرست یہاں مل سکتی ہے
- قسم: stringtasks
.status _message ٹاسک کا معلوماتی پیغام۔ عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے
- قسم: stringtasks
.time عمل درآمد کا وقت، سیکنڈز
- قسم: stringtime
عمل درآمد کا وقت، سیکنڈز
- قسم: stringversion
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/llm_mentions/search/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": [
{}
],
"location_name": "",
"location_code": 1,
"language_name": "",
"language_code": "",
"platform": "",
"filters": [],
"order_by": [
""
],
"offset": 1,
"search_after_token": "",
"limit": 1,
"tag": ""
}
]'
{
"version": "string",
"status_code": 1,
"status_message": "string",
"time": "string",
"cost": 1,
"tasks_count": 1,
"tasks_error": 1,
"tasks": [
"string"
],
"tasks.id": "string",
"tasks.status_code": 1,
"tasks.status_message": "string",
"tasks.time": "string",
"tasks.cost": 1,
"tasks.result_count": 1,
"tasks.path": [
"string"
],
"tasks.data": {},
"tasks.result": [
"string"
],
"tasks.result.total_count": 1,
"tasks.result.current_offset": 1,
"tasks.result.search_after_token": "string",
"tasks.result.items_count": 1,
"tasks.result.items": [
"string"
],
"tasks.result.items.platform": "string",
"tasks.result.items.model_name": "string",
"tasks.result.items.location_code": 1,
"tasks.result.items.language_code": "string",
"tasks.result.items.question": "string",
"tasks.result.items.answer": "string",
"tasks.result.items.sources": [
"string"
],
"tasks.result.items.sources.snippet": "string",
"tasks.result.items.sources.source_name": "string",
"tasks.result.items.sources.thumbnail": "string",
"tasks.result.items.sources.markdown": "string",
"tasks.result.items.sources.position": 1,
"tasks.result.items.sources.title": "string",
"tasks.result.items.sources.domain": "string",
"tasks.result.items.sources.url": "string",
"tasks.result.items.sources.publication_date": "string",
"tasks.result.items.search_results": [
"string"
],
"tasks.result.items.search_results.description": "string",
"tasks.result.items.search_results.breadcrumb": "string",
"tasks.result.items.search_results.position": 1,
"tasks.result.items.search_results.title": "string",
"tasks.result.items.search_results.domain": "string",
"tasks.result.items.search_results.url": "string",
"tasks.result.items.search_results.publication_date": "string",
"tasks.result.items.ai_search_volume": 1,
"tasks.result.items.monthly_searches": [
"string"
],
"tasks.result.items.monthly_searches.year": 1,
"tasks.result.items.monthly_searches.month": 1,
"tasks.result.items.monthly_searches.search_volume": 1,
"tasks.result.items.first_response_at": "string",
"tasks.result.items.last_response_at": "string",
"tasks.result.items.brand_entities": [
"string"
],
"tasks.result.items.brand_entities.position": 1,
"tasks.result.items.brand_entities.title": "string",
"tasks.result.items.brand_entities.category": "string",
"tasks.result.items.fan_out_queries": [
"string"
]
}