‘Search Volume’ लाइव टास्क सेट करना

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/search_volume/live

‘Search Volume’ लाइव टास्क सेट करना

keywords की सूची के लिए Bing सर्च वॉल्यूम। keyword, location_code, language_code, search_partners, device, competition, cpc, search_volume, categories और monthly_searches लौटाता है — ध्यान दें कि categories इसमें है जो Google समकक्ष नहीं लौटाता, और competition_index नहीं है। DataForSEO के envelope में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में — अस्वीकृत request फिर भी HTTP 200 लौटाता है। Google समकक्ष post_dataforseo_keywords_gads_search_volume_live है; जब audience केवल Google पर न हो तो दोनों चलाएँ। इस endpoint के submit और fetch जुड़वाँ टास्क वही काम async रूप से, उसी कीमत पर करते हैं — उन बैचों के लिए जिनका इंतज़ार करना संभव न हो।

मूल्य संदर्भ

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

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

बॉडी

application/json

टाइप: array (object | null)[]
- date_from
  टाइप: string | null
  
  समय सीमा की प्रारंभ तिथि
  वैकल्पिक फ़ील्ड
  न्यूनतम मान: आज की तिथि से 24 महीने;
  यदि आप यह फ़ील्ड निर्दिष्ट नहीं करते हैं, तो पिछले 12 महीनों का डेटा दिया जाएगा;
  न्यूनतम मान: आज की तिथि से दो वर्ष पहले;
  यदि Status endpoint actual_data फ़ील्ड में false लौटाता है, तो date_from को पिछले महीने से पहले और उससे पहले तक सेट किया जा सकता है;
  यदि Status endpoint actual_data फ़ील्ड में true लौटाता है, तो date_from को पिछले महीने और उससे पहले तक सेट किया जा सकता है;
  तिथि प्रारूप: "yyyy-mm-dd"
  उदाहरण:
  "2020-01-01"नोट: हम पिछले वर्ष की तिथियों के लिए कस्टम समय सीमा उपयोग करने की सलाह नहीं देते
- date_to
  टाइप: string | null
  
  समय सीमा की समाप्ति तिथि
  वैकल्पिक फ़ील्ड
  यदि आप यह फ़ील्ड निर्दिष्ट नहीं करते हैं, तो पिछले 12 महीनों का डेटा दिया जाएगा;
  न्यूनतम मान: आज की तिथि से दो वर्ष पहले;
  अधिकतम मान: आज की तिथि से एक महीना;
  नोट: हम पिछले वर्ष की तिथियों के लिए कस्टम समय सीमा उपयोग करने की सलाह नहीं देते;
  तिथि प्रारूप: "yyyy-mm-dd"
  उदाहरण:
  "2020-03-15"नोट: हम पिछले वर्ष की तिथियों के लिए कस्टम समय सीमा उपयोग करने की सलाह नहीं देते
- device
  टाइप: string | null
  
  डिवाइस प्रकार
  वैकल्पिक फ़ील्ड
  किसी विशेष डिवाइस प्रकार का डेटा चाहिए तो यह फ़ील्ड निर्दिष्ट करें;
  संभावित मान: all, mobile, desktop, tablet
  डिफ़ॉल्ट मान: all
- keywords
  टाइप: array string[]
  
  keywords
  आवश्यक फ़ील्ड
  अधिकतम कितने कीवर्ड निर्दिष्ट कर सकते हैं: 1000
  प्रत्येक कीवर्ड के लिए अधिकतम अक्षर: 100
  निर्दिष्ट कीवर्ड lowercase प्रारूप में बदल दिए जाएँगे, डेटा एक अलग सरणी में प्रदान किया जाएगा DataForSEO API में keyword और keywords फ़ील्ड के नियमों और सीमाओं के बारे में इस Help Center लेख में और जानें
- language_code
  टाइप: string
  
  सर्च इंजन भाषा कोड
  यदि language_name निर्दिष्ट नहीं करते हैं तो आवश्यक फ़ील्ड
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो language_name निर्दिष्ट करने की आवश्यकता नहीं है
  समर्थित भाषाएँ:
  en, fr, de
- language_name
  टाइप: string
  
  सर्च इंजन भाषा का पूरा नाम
  यदि language_code निर्दिष्ट नहीं करते हैं तो आवश्यक फ़ील्ड
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो language_code निर्दिष्ट करने की आवश्यकता नहीं है
  समर्थित भाषाएँ:
  English, French, German
- location_code
  टाइप: integer
  
  सर्च इंजन स्थान कोड
  यदि location_name या location_coordinate निर्दिष्ट नहीं करते हैं तो आवश्यक फ़ील्ड
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_name या location_coordinate निर्दिष्ट करने की आवश्यकता नहीं है
  आप location_code के साथ सर्च इंजन के उपलब्ध स्थानों की सूची https://api.dataforseo.com/v3/keywords_data/bing/locations पर अलग रिक्वेस्ट भेजकर प्राप्त कर सकते हैं
  उदाहरण:
  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 निर्दिष्ट करने की आवश्यकता नहीं है
  आप location_name के साथ सर्च इंजन के उपलब्ध स्थानों की सूची https://api.dataforseo.com/v3/keywords_data/bing/locations पर अलग रिक्वेस्ट भेजकर प्राप्त कर सकते हैं
  उदाहरण:
  London,England,United Kingdom
- search_partners
  टाइप: boolean | null
  
  Bing सर्च पार्टनर प्रकार
  वैकल्पिक फ़ील्ड
  यदि आप true निर्दिष्ट करते हैं, तो परिणाम Bing, Yahoo, AOL और उन पार्टनर साइटों के स्वामित्व वाले, संचालित और सिंडिकेटेड नेटवर्क के लिए दिए जाएँगे जो Bing, AOL और Yahoo सर्च होस्ट करते हैं।
  डिफ़ॉल्ट मान: false - परिणाम Bing, AOL और Yahoo सर्च नेटवर्क के लिए लौटाए जाते हैं
- sort_by
  टाइप: string | null
  
  परिणाम सॉर्टिंग पैरामीटर
  वैकल्पिक फ़ील्ड
  परिणामों को search_volume, cpc, competition या relevance के अनुसार अवरोही क्रम में सॉर्ट करने के लिए इन पैरामीटर का उपयोग करें
  डिफ़ॉल्ट मान: relevance
- tag
  टाइप: string | null
  
  उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
  वैकल्पिक फ़ील्ड
  अक्षर सीमा 255 है
  आप इस पैरामीटर से टास्क पहचान सकते हैं और उसे परिणाम से मिला सकते हैं
  निर्दिष्ट tag मान response के data ऑब्जेक्ट में मिलेगा

responses

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

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

status_code
टाइप: integer | null

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

status_message
टाइप: string | null

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

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

टास्क का ऐरे

टाइप: object | null · Response36Afe1097B20_KeywordsDataBingSearchVolumeLiveTaskInfo
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

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

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

उत्पाद और सेवा श्रेणियाँ
हमारा API इस endpoint के लिए श्रेणियाँ नहीं लौटाता: पैरामीटर हमेशा null के बराबर होगा

competition
टाइप: number | null

प्रतिस्पर्धा
केवल पेड SERP में दिए गए कीवर्ड से जुड़ी सापेक्ष प्रतिस्पर्धा मात्रा दर्शाता है। यह मान Bing Ads डेटा पर आधारित है
संभावित मान: 0.1, 0.5,0.90.1 - कम प्रतिस्पर्धा,
0.5 - मध्यम प्रतिस्पर्धा,
0.9 - उच्च प्रतिस्पर्धा;
यदि कोई डेटा नहीं है, तो मान null है

cpc
टाइप: number | null

प्रति क्लिक लागत
कीवर्ड के लिए ऐतिहासिक रूप से भुगतान की गई औसत प्रति क्लिक लागत (USD) दर्शाता है
यदि कोई डेटा नहीं है, तो मान null है

device
टाइप: string | null

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

keyword
टाइप: string | null

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

language_code
टाइप: string | null

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

location_code
टाइप: integer | null

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

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

मासिक सर्च
निर्दिष्ट भौगोलिक स्थानों को लक्षित इस कीवर्ड आइडिया पर सर्च की (अनुमानित) संख्या दर्शाता है (जैसा पिछले बारह महीनों के लिए उपलब्ध है)
यदि कोई डेटा नहीं है, तो मान null है

month
टाइप: integer | null

महीना

search_volume
टाइप: integer | null

औसत मासिक सर्च वॉल्यूम दर

year
टाइप: integer | null

वर्ष

search_partners
टाइप: boolean | null

दर्शाता है कि response में पार्टनर नेटवर्क का डेटा शामिल है या नहीं

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

औसत मासिक सर्च वॉल्यूम दर
उपयोगकर्ता की टार्गेटिंग के आधार पर Bing सर्च इंजन पर दिए गए कीवर्ड आइडिया के लिए सर्च की (अनुमानित) संख्या दर्शाता है;
सर्च वॉल्यूम को निकटतम दहाई तक पूर्णांकित किया जाता है;
यदि कोई डेटा नहीं है, तो मान 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/search_volume/live

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/search_volume/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_name": "United States",
    "language_code": "en",
    "keywords": [
      "tom and jerry",
      "silicon valley",
      "spider man"
    ]
  }
]'

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

{
  "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,
          "search_partners": null,
          "device": null,
          "competition": null,
          "cpc": null,
          "search_volume": null,
          "categories": [
            null
          ],
          "monthly_searches": [
            {
              "year": null,
              "month": null,
              "search_volume": null
            }
          ]
        }
      ]
    }
  ]
}

सफल ऑपरेशन

‘Search Volume’ लाइव टास्क सेट करना

प्रमाणीकरणRequired

DataForSEO

‘Search Volume’ लाइव टास्क सेट करना

मूल्य संदर्भ