‘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/task_post

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

Bing keyword-performance टास्क कतार में डालता है और टास्क id लौटाता है। ⚠️ लाइव जुड़वाँ जैसी ही शर्त: language_name मौजूद होना चाहिए। DataForSEO के envelope में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में — अस्वीकृत request फिर भी HTTP 200 लौटाता है। get_dataforseo_keywords_bing_kw_performance_fetch से प्राप्त करें।

मूल्य संदर्भ

मीटरिंग: रिपोर्ट किया गया 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 मैच प्रकार लागू होता है
- pingback_url
  टाइप: string | null
  
  पूर्ण टास्क का नोटिफ़िकेशन URL
  वैकल्पिक फ़ील्ड
  टास्क पूरा होने पर हम आपके निर्दिष्ट URL पर GET request भेजकर सूचित करेंगे
  आप ‘$id’ स्ट्रिंग को $id वैरिएबल के रूप में और ‘$tag’ को URL-एन्कोडेड $tag वैरिएबल के रूप में उपयोग कर सकते हैं। request भेजने से पहले हम आवश्यक मान सेट करेंगे
  उदाहरण:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  नोट: pingback_url में विशेष वर्ण URL-एन्कोड होंगे;
  अर्थात्, # वर्ण %23 में एन्कोड होगा
  
  हमारे Help Center पर और जानें
- postback_url
  टाइप: string | null
  
  टास्क परिणाम भेजने का URL
  वैकल्पिक फ़ील्ड
  टास्क पूरा होने पर हम उसके परिणामों को gzip प्रारूप में संपीड़ित करके आपके निर्दिष्ट postback_url पर POST request भेजेंगे
  आप ‘$id’ स्ट्रिंग को $id वैरिएबल के रूप में और ‘$tag’ को URL-एन्कोडेड $tag वैरिएबल के रूप में उपयोग कर सकते हैं। request भेजने से पहले हम आवश्यक मान सेट करेंगे।
  उदाहरण:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  नोट: postback_url में विशेष वर्ण URL-एन्कोड होंगे;
  अर्थात्, # वर्ण %23 में एन्कोड होगा
  
  हमारे Help Center पर और जानें
- tag
  टाइप: string | null
  
  उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
  वैकल्पिक फ़ील्ड
  अक्षर सीमा 255 है
  आप इस पैरामीटर से टास्क पहचान सकते हैं और उसे परिणाम से मिला सकते हैं
  निर्दिष्ट tag मान response के data ऑब्जेक्ट में मिलेगा

responses

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

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

status_code
टाइप: integer | null

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

status_message
टाइप: string | null

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

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

टास्क का ऐरे

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

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

data
टाइप: object | null

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

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

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

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

URL पथ

result
टाइप: object | null

परिणामों का ऐरे
इस मामले में, मान null होगा

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/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/keyword_performance/task_post \
  --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": null
    }
  ]
}

सफल ऑपरेशन

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

प्रमाणीकरणRequired

DataForSEO

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

मूल्य संदर्भ