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

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

Bing search-volume टास्क कतार में डालता है और टास्क id लौटाता है। DataForSEO के envelope में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में — अस्वीकृत request फिर भी HTTP 200 लौटाता है। get_dataforseo_keywords_bing_search_volume_fetch से प्राप्त करें।

मूल्य संदर्भ

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

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

बॉडी

application/json

टाइप: array (object | null)[]
- date_from
  टाइप: string | null
  
  समय सीमा की प्रारंभ तिथि
  वैकल्पिक फ़ील्ड
  यदि आप यह फ़ील्ड निर्दिष्ट नहीं करते हैं, तो पिछले 12 महीनों का डेटा दिया जाएगा
  न्यूनतम मान: आज की तिथि से 24 महीने
  यदि 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
- 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 पर और जानें
- 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_KeywordsDataBingSearchVolumeTaskPostResponseInfo
cost
टाइप: number | null फ़ॉर्मेट: double

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

status_code
टाइप: integer | null

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

status_message
टाइप: string | null

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

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

टास्क का ऐरे

टाइप: object | null · Response36Afe1097B20_KeywordsDataBingSearchVolumeTaskPostTaskInfo
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/search_volume/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/search_volume/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_name": "United States",
    "language_name": "English",
    "keywords": [
      "average page rpm adsense",
      "adsense blank ads how long",
      "leads and prospects"
    ]
  }
]'

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

{
  "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
    }
  ]
}

सफल ऑपरेशन

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

प्रमाणीकरणRequired

DataForSEO

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

मूल्य संदर्भ