DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
लाइव LLM Mentions
वे अलग-अलग उत्तर जिनमें किसी सहायक ने आपके टारगेट का उल्लेख किया। total_count, current_offset, search_after_token और items लौटाता है — पहले कुछ पेजों के बाद offset के बजाय टोकन से पेजिंग करें। ⚠️ target ऑब्जेक्ट की सूची है, हर आइटम {"domain": "..."} या {"keyword": "..."}; सादा स्ट्रिंग गलत प्रकार के रूप में और स्ट्रिंग की सूची 'Each target item must be an object' के रूप में अस्वीकृत होती है। फ़िल्टर फ़ील्ड get_dataforseo_ai_llm_mentions_available_filters से आते हैं। DataForSEO के envelope में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में — अस्वीकृत request भी HTTP 200 ही लौटाता है। मेंशन के बजाय गिनती चाहिए तो post_dataforseo_ai_llm_mentions_aggregated_metrics_live उपयोग करें।
मूल्य संदर्भ
- मीटरिंग: रिपोर्ट किया गया response लागत।
- संदर्भ request अनुमान: USD 0.701
- संदर्भ ग्राहक गुणक: 1.0. अंतिम रूप से निपटाई गई ग्राहक राशि पर इसे दोबारा लागू न करें।
केवल संदर्भ मेटाडेटा, खाते का कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। Resource credits, 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 API में 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 पर अलग request भेजकर प्राप्त कर सकते हैं डिफ़ॉल्ट मान: 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 पर अलग request भेजकर प्राप्त कर सकते हैं नोट: 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 पर अलग request भेजकर प्राप्त कर सकते हैं डिफ़ॉल्ट मान: 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 पर अलग request भेजकर प्राप्त कर सकते हैं नोट: chat_gpt डेटा केवल संयुक्त राज्य अमेरिका के लिए उपलब्ध है
- offsetटाइप: integer
लौटाए गए मेंशन डेटा की परिणाम सरणी में ऑफ़सेट वैकल्पिक फ़ील्ड डिफ़ॉल्ट मान: 0 उदाहरण: यदि आप 10 मान निर्दिष्ट करते हैं, तो परिणाम सरणी में पहले दस मेंशन ऑब्जेक्ट छोड़ दिए जाएँगे और डेटा अगले ऑब्जेक्ट के लिए प्रदान किया जाएगा; नोट: अधिकतम मान 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 डेटा केवल संयुक्त राज्य अमेरिका और अंग्रेज़ी के लिए उपलब्ध है
- searchटाइप: string
_after _token बाद की रिक्वेस्ट के लिए टोकन वैकल्पिक फ़ील्ड प्रत्येक रिक्वेस्ट के रिस्पॉन्स के identical फ़ील्ड में प्रदान किया जाता है; एक ही रिक्वेस्ट में 20,000 से अधिक परिणाम प्राप्त करते समय टाइमआउट से बचने के लिए इस पैरामीटर का उपयोग करें; रिस्पॉन्स सरणी से अनोखा search_after_token मान निर्दिष्ट करके आपको प्रारंभिक टास्क के बाद के परिणाम मिलेंगे; search_after_token मान प्रत्येक बाद के टास्क के लिए अनोखे होते हैं ; नोट: यदि रिक्वेस्ट में search_after_token निर्दिष्ट है, तो अन्य सभी पैरामीटर पिछली रिक्वेस्ट के समान होने चाहिए
- tagटाइप: string
उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर वैकल्पिक फ़ील्ड अक्षर सीमा 255 है आप इस पैरामीटर से टास्क पहचान सकते हैं और उसे परिणाम से मिला सकते हैं निर्दिष्ट tag मान response के data ऑब्जेक्ट में मिलेगा
- टाइप: object200
सफल response
- टाइप: numbercost
टास्क की कुल लागत, USD
- टाइप: integerstatus
_code सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है नोट: हम दृढ़ता से अनुशंसा करते हैं कि संबंधित असामान्य या त्रुटि स्थितियों को संभालने के लिए आवश्यक सिस्टम डिज़ाइन करें
- टाइप: stringstatus
_message सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- टाइप: array string[]tasks
टास्क का ऐरे
- टाइप: integertasks
_count tasks ऐरे में टास्क की संख्या
- टाइप: integertasks
_error त्रुटि के साथ लौटाए गए tasks ऐरे में टास्क की संख्या
- टाइप: numbertasks
.cost टास्क की लागत, USD
- टाइप: objecttasks
.data इसमें वही पैरामीटर हैं जो आपने POST request में निर्दिष्ट किए थे
- टाइप: stringtasks
.id टास्क आइडेंटिफ़ायर हमारे सिस्टम में UUID प्रारूप में अद्वितीय टास्क आइडेंटिफ़ायर
- टाइप: array string[]tasks
.path URL पथ
- टाइप: array string[]tasks
.result परिणामों का ऐरे
- टाइप: integertasks
.result _count result ऐरे में एलिमेंट की संख्या
- टाइप: integertasks
.result .current _offset items सरणी में छोड़े गए मेंशन ऑब्जेक्ट की संख्या
- टाइप: array string[]tasks
.result .items प्रासंगिक मेंशन डेटा शामिल है
- टाइप: integertasks
.result .items _count items सरणी में लौटाए गए परिणामों की संख्या
- टाइप: integertasks
.result .items .ai _search _volume कीवर्ड की वर्तमान AI सर्च वॉल्यूम इस मेट्रिक के बारे में यहाँ और जानें
- टाइप: stringtasks
.result .items .answer markdown प्रारूप में प्रासंगिक उत्तर markdown मार्कअप भाषा में स्वरूपित परिणाम की सामग्री
- टाइप: array string[]tasks
.result .items .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 फैन-आउट क्वेरी की सरणी मुख्य क्वेरी से व्युत्पन्न संबंधित सर्च क्वेरी शामिल हैं ताकि अधिक व्यापक उत्तर मिल सके
- टाइप: 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 markdown प्रारूप में तत्व की सामग्री 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 response कोड की पूरी सूची यहाँ देखी जा सकती है
- टाइप: stringtasks
.status _message टास्क का सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- टाइप: stringtasks
.time निष्पादन समय, सेकंड
- टाइप: stringtime
निष्पादन समय, सेकंड
- टाइप: stringversion
API का वर्तमान संस्करण
application/json - 400
request संसाधित नहीं किया जा सका। request पैरामीटर जाँचें।
- 401
एक वैध Felo API key आवश्यक है।
- 402
request आगे नहीं बढ़ सकता क्योंकि बिलिंग आवश्यकता पूरी नहीं हुई है।
- 403
खाते को यह ऑपरेशन करने की अनुमति नहीं है।
- 429
request या खर्च की सीमा तक पहुँच गए हैं।
- 502
सेवा request पूरा नहीं कर सकी।
- 503
API या बिलिंग सेवा अस्थायी रूप से उपलब्ध नहीं है।
- 504
request संसाधित करते समय सेवा का समय समाप्त हो गया।
- default
त्रुटि response; upstream passthrough response प्रोवाइडर फ़ॉर्मेट का उपयोग कर सकते हैं।
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"
]
}