‘Bing Keyword Performance’ लाइव टास्क सेट करना

Felo API Support

MIT

सर्वर

https://openapi.felo.ai

क्लाइंट लाइब्रेरी

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO ऑपरेशन

post/v1/beta/dataforseo/keywords_data/bing/keyword_performance/live

‘Bing Keyword Performance’ लाइव टास्क सेट करना

दिए गए device और match प्रकार के लिए Bing Ads में keywords की सूची का प्रदर्शन। ⚠️ language_name आवश्यक है और इसकी अनुपस्थिति HTTP 200 के अंदर Invalid Field: 'language_name' के रूप में रिपोर्ट होती है — यह संदेश गायब होने के साथ-साथ गलत होने का भी अर्थ देता है। DataForSEO के envelope में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में — अस्वीकृत request फिर भी HTTP 200 लौटाता है। मान्य जोड़ियाँ get_dataforseo_keywords_bing_kw_performance_locales से आती हैं। इस endpoint के submit और fetch जुड़वाँ टास्क वही काम async रूप से, उसी कीमत पर करते हैं — उन बैचों के लिए जिनका इंतज़ार करना संभव न हो।

मूल्य संदर्भ

मीटरिंग: रिपोर्ट किया गया response लागत
संदर्भ request अनुमान: USD 0.09
संदर्भ ग्राहक गुणक: 1.0। निपटाई गई ग्राहक राशि पर इसे दोबारा लागू न करें।

यह केवल संदर्भ मेटाडेटा है — खाते का कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। रिसोर्स क्रेडिट Felo क्रेडिट नहीं हैं। अंतिम शुल्क Felo बिलिंग रिकॉर्ड के अनुसार लगते हैं।

बॉडी

application/json

टाइप: array (object | null)[]
- device
  टाइप: string | null
  
  डिवाइस प्रकार
  वैकल्पिक फ़ील्ड
  किसी विशेष डिवाइस प्रकार का डेटा चाहिए तो यह फ़ील्ड निर्दिष्ट करें संभावित मान: desktop, mobile, tablet, all
  डिफ़ॉल्ट मान: all
- keywords
  टाइप: array string[]
  
  keywords
  आवश्यक फ़ील्ड
  अधिकतम कितने कीवर्ड निर्दिष्ट कर सकते हैं: 1000
  प्रत्येक कीवर्ड के लिए अधिकतम अक्षर: 80
  प्रत्येक कीवर्ड वाक्यांश के लिए अधिकतम शब्द: 10
  निर्दिष्ट कीवर्ड lowercase प्रारूप में बदल दिए जाएँगे, डेटा एक अलग सरणी में प्रदान किया जाएगा
  
  DataForSEO API में keyword और keywords फ़ील्ड के नियमों और सीमाओं के बारे में इस Help Center लेख में और जानें
- language_code
  टाइप: string
  
  सर्च इंजन भाषा कोड
  यदि language_name निर्दिष्ट नहीं करते हैं तो आवश्यक फ़ील्ड
  आप उपलब्ध स्थानों और भाषाओं की सूची https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages पर अलग रिक्वेस्ट भेजकर प्राप्त कर सकते हैं
  उदाहरण:
  "en"
- language_name
  टाइप: string
  
  सर्च इंजन भाषा का पूरा नाम
  यदि language_code निर्दिष्ट नहीं करते हैं तो आवश्यक फ़ील्ड
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो language_code निर्दिष्ट करने की आवश्यकता नहीं है
  आप उपलब्ध स्थानों और भाषाओं की सूची https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages पर अलग रिक्वेस्ट भेजकर प्राप्त कर सकते हैं
  उदाहरण:
  English
- location_code
  टाइप: integer
  
  सर्च इंजन स्थान कोड
  यदि location_name या location_coordinate निर्दिष्ट नहीं करते हैं तो आवश्यक फ़ील्ड
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_name या location_coordinate निर्दिष्ट करने की आवश्यकता नहीं है
  आप उपलब्ध स्थानों और भाषाओं की सूची https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages पर अलग रिक्वेस्ट भेजकर प्राप्त कर सकते हैं
  उदाहरण:
  2840
- location_coordinate
  टाइप: string
  
  स्थान के GPS निर्देशांक
  यदि location_name या location_code निर्दिष्ट नहीं करते हैं तो आवश्यक फ़ील्ड
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_name या location_code निर्दिष्ट करने की आवश्यकता नहीं है
  पैरामीटर location_coordinate को "latitude,longitude" प्रारूप में निर्दिष्ट किया जाना चाहिए
  डेटा उस देश के लिए दिया जाएगा जिससे निर्दिष्ट निर्देशांक संबंधित हैं
  उदाहरण:
  52.6178549,-155.352142
- location_name
  टाइप: string
  
  सर्च इंजन स्थान का पूरा नाम
  यदि location_code या location_coordinate निर्दिष्ट नहीं करते हैं तो आवश्यक फ़ील्ड
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_code या location_coordinate निर्दिष्ट करने की आवश्यकता नहीं है
  आप उपलब्ध स्थानों और भाषाओं की सूची https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages पर अलग रिक्वेस्ट भेजकर प्राप्त कर सकते हैं
  उदाहरण:
  "United States"
- match
  टाइप: string | null
  
  कीवर्ड मैच प्रकार
  वैकल्पिक फ़ील्ड
  यह निम्न मान ले सकता है:
  aggregate सभी मैच प्रकारों का डेटा लौटाता है;
  broad निर्दिष्ट कीवर्ड वाले सभी उपयोगकर्ता क्वेरी के लिए डेटा लौटाता है, जिनमें शब्द क्रम बदला हुआ हो सकता है;
  phrase निर्दिष्ट कीवर्ड वाले सभी उपयोगकर्ता क्वेरी के लिए डेटा लौटाता है, जिनमें शब्द क्रम समान है;
  exact निर्दिष्ट कीवर्ड से मेल खाने वाली उपयोगकर्ता क्वेरी के लिए डेटा लौटाता है;नोट: डिफ़ॉल्ट रूप से aggregate मैच प्रकार लागू होता है
- tag
  टाइप: string | null
  
  उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
  वैकल्पिक फ़ील्ड
  अक्षर सीमा 255 है
  आप इस पैरामीटर से टास्क पहचान सकते हैं और उसे परिणाम से मिला सकते हैं
  निर्दिष्ट tag मान response के data ऑब्जेक्ट में मिलेगा

responses

200
टाइप: object | null · Response36Afe1097B20_KeywordsDataBingKeywordPerformanceLiveResponseInfo
cost
टाइप: number | null फ़ॉर्मेट: double

टास्क की कुल लागत, USD

status_code
टाइप: integer | null

सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है

status_message
टाइप: string | null

सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है

tasks
टाइप: array (object | null)[] | null

टास्क का ऐरे

टाइप: object | null · Response36Afe1097B20_KeywordsDataBingKeywordPerformanceLiveTaskInfo
cost
टाइप: number | null फ़ॉर्मेट: double

टास्क की कुल लागत, USD

data
टाइप: object | null

इसमें वही पैरामीटर हैं जो आपने POST request में निर्दिष्ट किए थे

propertyName
टाइप: object | null
id
टाइप: string | null

टास्क आइडेंटिफ़ायर हमारे सिस्टम में अद्वितीय टास्क आइडेंटिफ़ायर, UUID प्रारूप में

path
टाइप: array (string | null)[] | null

URL पथ

result
टाइप: array (object | null)[] | null

परिणामों का ऐरे

keyword
टाइप: string | null

POST ऐरे में कीवर्ड

keyword_kpi
टाइप: object | null · Response36Afe1097B20_KeywordKpi

कीवर्ड मेट्रिक वाला ऑब्जेक्ट
यदि कोई डेटा नहीं है, तो मान null है

desktop
टाइप: array (object | null)[] | null

डेस्कटॉप डिवाइस के लिए एकत्रित कीवर्ड डेटा
यदि कोई डेटा नहीं है, तो मान null है

ad_position
टाइप: string | null

SERP में संबंधित विज्ञापन की स्थिति दर्शाता है
निम्नलिखित मान ले सकता है:
FirstPage1: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला पहला विज्ञापन
FirstPage2: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला दूसरा विज्ञापन
FirstPage3: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला तीसरा विज्ञापन
FirstPage4: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला चौथा विज्ञापन
FirstPage5: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला पाँचवाँ विज्ञापन
FirstPage6: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला छठा विज्ञापन
FirstPage7: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला सातवाँ विज्ञापन
FirstPage8: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला आठवाँ विज्ञापन
FirstPage9: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला नौवाँ विज्ञापन
FirstPage10: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला दसवाँ विज्ञापन
MainLine1: सर्च परिणाम पेज के शीर्ष पर दिखने वाला पहला विज्ञापन
MainLine2: सर्च परिणाम पेज के शीर्ष पर दिखने वाला दूसरा विज्ञापन
MainLine3: सर्च परिणाम पेज के शीर्ष पर दिखने वाला तीसरा विज्ञापन
MainLine4: सर्च परिणाम पेज के शीर्ष पर दिखने वाला चौथा विज्ञापन

average_bid
टाइप: number | null फ़ॉर्मेट: double

कीवर्ड की औसत बिड

average_cpc
टाइप: number | null फ़ॉर्मेट: double

औसत प्रति क्लिक लागत, USD
सभी क्लिक की लागत को क्लिक की संख्या से विभाजित करके गणना की जाती है

clicks
टाइप: integer | null

विज्ञापन क्लिक
पिछले महीने में कीवर्ड और मैच प्रकार द्वारा उत्पन्न क्लिक की संख्या

ctr
टाइप: number | null फ़ॉर्मेट: double

प्रतिशत के रूप में क्लिक-थ्रू रेट
क्लिक की संख्या को इम्प्रेशन की संख्या से विभाजित करके और परिणाम को 100 से गुणा करके गणना की जाती है

impressions
टाइप: integer | null

विज्ञापन इम्प्रेशन
पिछले महीने में कीवर्ड और मैच प्रकार द्वारा उत्पन्न इम्प्रेशन की संख्या

total_cost
टाइप: number | null फ़ॉर्मेट: int64

विज्ञापन की कुल लागत, USD
पिछले महीने में निर्दिष्ट कीवर्ड और मैच प्रकार का उपयोग करने की लागत

mobile
टाइप: array (object | null)[] | null

मोबाइल डिवाइस के लिए एकत्रित कीवर्ड डेटा
यदि कोई डेटा नहीं है, तो मान null है

ad_position
टाइप: string | null

SERP में संबंधित विज्ञापन की स्थिति दर्शाता है
निम्नलिखित मान ले सकता है:
FirstPage1: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला पहला विज्ञापन
FirstPage2: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला दूसरा विज्ञापन
FirstPage3: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला तीसरा विज्ञापन
FirstPage4: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला चौथा विज्ञापन
FirstPage5: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला पाँचवाँ विज्ञापन
FirstPage6: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला छठा विज्ञापन
FirstPage7: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला सातवाँ विज्ञापन
FirstPage8: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला आठवाँ विज्ञापन
FirstPage9: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला नौवाँ विज्ञापन
FirstPage10: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला दसवाँ विज्ञापन
MainLine1: सर्च परिणाम पेज के शीर्ष पर दिखने वाला पहला विज्ञापन
MainLine2: सर्च परिणाम पेज के शीर्ष पर दिखने वाला दूसरा विज्ञापन
MainLine3: सर्च परिणाम पेज के शीर्ष पर दिखने वाला तीसरा विज्ञापन
MainLine4: सर्च परिणाम पेज के शीर्ष पर दिखने वाला चौथा विज्ञापन

average_bid
टाइप: number | null फ़ॉर्मेट: double

कीवर्ड की औसत बिड

average_cpc
टाइप: number | null फ़ॉर्मेट: double

औसत प्रति क्लिक लागत, USD
सभी क्लिक की लागत को क्लिक की संख्या से विभाजित करके गणना की जाती है

clicks
टाइप: integer | null

विज्ञापन क्लिक
पिछले महीने में कीवर्ड और मैच प्रकार द्वारा उत्पन्न क्लिक की संख्या

ctr
टाइप: number | null फ़ॉर्मेट: double

प्रतिशत के रूप में क्लिक-थ्रू रेट
क्लिक की संख्या को इम्प्रेशन की संख्या से विभाजित करके और परिणाम को 100 से गुणा करके गणना की जाती है

impressions
टाइप: integer | null

विज्ञापन इम्प्रेशन
पिछले महीने में कीवर्ड और मैच प्रकार द्वारा उत्पन्न इम्प्रेशन की संख्या

total_cost
टाइप: number | null फ़ॉर्मेट: int64

विज्ञापन की कुल लागत, USD
पिछले महीने में निर्दिष्ट कीवर्ड और मैच प्रकार का उपयोग करने की लागत

tablet
टाइप: array (object | null)[] | null

टैबलेट डिवाइस के लिए एकत्रित कीवर्ड डेटा
यदि कोई डेटा नहीं है, तो मान null है

ad_position
टाइप: string | null

SERP में संबंधित विज्ञापन की स्थिति दर्शाता है
निम्नलिखित मान ले सकता है:
FirstPage1: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला पहला विज्ञापन
FirstPage2: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला दूसरा विज्ञापन
FirstPage3: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला तीसरा विज्ञापन
FirstPage4: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला चौथा विज्ञापन
FirstPage5: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला पाँचवाँ विज्ञापन
FirstPage6: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला छठा विज्ञापन
FirstPage7: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला सातवाँ विज्ञापन
FirstPage8: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला आठवाँ विज्ञापन
FirstPage9: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला नौवाँ विज्ञापन
FirstPage10: पहले सर्च परिणाम पेज के दाईं ओर दिखने वाला दसवाँ विज्ञापन
MainLine1: सर्च परिणाम पेज के शीर्ष पर दिखने वाला पहला विज्ञापन
MainLine2: सर्च परिणाम पेज के शीर्ष पर दिखने वाला दूसरा विज्ञापन
MainLine3: सर्च परिणाम पेज के शीर्ष पर दिखने वाला तीसरा विज्ञापन
MainLine4: सर्च परिणाम पेज के शीर्ष पर दिखने वाला चौथा विज्ञापन

average_bid
टाइप: number | null फ़ॉर्मेट: double

कीवर्ड की औसत बिड

average_cpc
टाइप: number | null फ़ॉर्मेट: double

औसत प्रति क्लिक लागत, USD
सभी क्लिक की लागत को क्लिक की संख्या से विभाजित करके गणना की जाती है

clicks
टाइप: integer | null

विज्ञापन क्लिक
पिछले महीने में कीवर्ड और मैच प्रकार द्वारा उत्पन्न क्लिक की संख्या

ctr
टाइप: number | null फ़ॉर्मेट: double

प्रतिशत के रूप में क्लिक-थ्रू रेट
क्लिक की संख्या को इम्प्रेशन की संख्या से विभाजित करके और परिणाम को 100 से गुणा करके गणना की जाती है

impressions
टाइप: integer | null

विज्ञापन इम्प्रेशन
पिछले महीने में कीवर्ड और मैच प्रकार द्वारा उत्पन्न इम्प्रेशन की संख्या

total_cost
टाइप: number | null फ़ॉर्मेट: int64

विज्ञापन की कुल लागत, USD
पिछले महीने में निर्दिष्ट कीवर्ड और मैच प्रकार का उपयोग करने की लागत

language_code
टाइप: string | null

POST सरणी में भाषा कोड
यदि कोई डेटा नहीं है, तो मान null है

location_code
टाइप: integer | null

POST सरणी में स्थान कोड
यदि कोई डेटा नहीं है, तो मान null है

month
टाइप: integer | null

वह महीना दर्शाता है जिसके लिए डेटा प्रदान किया गया है
उदाहरण:
10

year
टाइप: integer | null

वह वर्ष दर्शाता है जिसके लिए डेटा प्रदान किया गया है
उदाहरण:
2020

result_count
टाइप: integer | null फ़ॉर्मेट: int64

result ऐरे में एलिमेंट की संख्या

status_code
टाइप: integer | null

टास्क का स्टेटस कोड DataForSEO द्वारा जनरेट किया गया, यह निम्न श्रेणी में हो सकता है: 10000-60000 response कोड की पूरी सूची यहाँ देखी जा सकती है

status_message
टाइप: string | null

टास्क का सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है

time
टाइप: string | null

निष्पादन समय, सेकंड

tasks_count
टाइप: integer | null फ़ॉर्मेट: int64

tasks ऐरे में टास्क की संख्या

tasks_error
टाइप: integer | null फ़ॉर्मेट: int64

त्रुटि के साथ लौटाए गए tasks ऐरे में टास्क की संख्या

time
टाइप: string | null

कुल निष्पादन समय, सेकंड

version
टाइप: string | null

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

post/v1/beta/dataforseo/keywords_data/bing/keyword_performance/live

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/keyword_performance/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "language_code": "en",
    "keywords": [
      "dataforseo",
      "seo",
      "ranking"
    ]
  }
]'

स्कीमा दिखाएँ

{
  "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": [
        {
          "keyword": null,
          "location_code": null,
          "language_code": null,
          "year": null,
          "month": null,
          "keyword_kpi": {
            "desktop": [
              "[Max Depth Exceeded]"
            ],
            "mobile": [
              "[Max Depth Exceeded]"
            ],
            "tablet": [
              "[Max Depth Exceeded]"
            ]
          }
        }
      ]
    }
  ]
}

सफल ऑपरेशन

‘Bing Keyword Performance’ लाइव टास्क सेट करना

प्रमाणीकरणRequired

DataForSEO

‘Bing Keyword Performance’ लाइव टास्क सेट करना

मूल्य संदर्भ