लाइव ‘Google Ads Search Volume’ टास्क सेट करें
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
लाइव ‘Google Ads Search Volume’ टास्क सेट करें
keywords की सूची के लिए Google Ads सर्च वॉल्यूम। keyword, location_code, language_code, search_partners, competition, competition_index, search_volume, low_top_of_page_bid, high_top_of_page_bid, cpc और monthly_searches लौटाता है, साथ में spell जब Google ने शब्द सुधारा हो। DataForSEO के envelope में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में — अस्वीकृत request भी HTTP 200 ही लौटाता है। यह पारंपरिक सर्च-वॉल्यूम संख्या है; लोग कितनी बार किसी असिस्टेंट से पूछते हैं, यह जानने के लिए post_dataforseo_ai_keyword_volume_live का उपयोग करें। इस endpoint के सबमिट और फ़ेच जुड़वाँ यही काम असिंक्रोनस रूप से, उसी कीमत पर करते हैं, उन बैचों के लिए जिनका इंतज़ार नहीं किया जा सकता।
मूल्य संदर्भ
- मीटरिंग: रिपोर्ट किया गया response लागत
- संदर्भ request अनुमान: USD 0.09
- संदर्भ ग्राहक गुणक: 1.0। निपटाई गई ग्राहक राशि पर इसे दोबारा लागू न करें
यह केवल संदर्भ मेटाडेटा है — खाते का कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। रिसोर्स क्रेडिट Felo क्रेडिट नहीं हैं। अंतिम शुल्क Felo बिलिंग रिकॉर्ड के अनुसार लगते हैं।
- टाइप: array (object | null)[]
- dateटाइप: string | null
_from समय सीमा की प्रारंभ तिथि
वैकल्पिक फ़ील्ड
तिथि प्रारूप:"yyyy-mm-dd"
न्यूनतम मान: वर्तमान तिथि से 4 वर्ष पहले तक
डिफ़ॉल्ट रूप से, पिछले 12 महीनों का डेटा लौटाया जाता है;
नोट: निर्दिष्ट तिथिdate_toमें निर्दिष्ट तिथि और/या कल की तिथि से अधिक नहीं हो सकती; यदि Status endpointactual_dataफ़ील्ड मेंfalseलौटाता है, तोdate_fromको पिछले महीने से पहले के महीने और उससे पहले पर सेट किया जा सकता है;
यदि Status endpointactual_dataफ़ील्ड मेंtrueलौटाता है, तोdate_fromको पिछले महीने और उससे पहले पर सेट किया जा सकता है - dateटाइप: string | null
_to समय सीमा की समाप्ति तिथि
वैकल्पिक फ़ील्ड
नोट: निर्दिष्ट तिथि पिछले महीने से अधिक नहीं हो सकती, Google Ads वर्तमान महीने का डेटा नहीं लौटाता;
यदि आप यह फ़ील्ड निर्दिष्ट नहीं करते हैं, तो डिफ़ॉल्ट रूप से कल की तिथि उपयोग होगी
तिथि प्रारूप:"yyyy-mm-dd"
उदाहरण:"2022-11-30" - includeटाइप: boolean | null
_adult _keywords - keywordsटाइप: array string[]
कीवर्ड
आवश्यक फ़ील्ड
आप अधिकतम कितने कीवर्ड निर्दिष्ट कर सकते हैं: 1000
प्रत्येक कीवर्ड के लिए अधिकतम वर्ण: 80
प्रत्येक कीवर्ड वाक्यांश के लिए अधिकतम शब्द: 10
आपके द्वारा निर्दिष्ट कीवर्ड lowercase प्रारूप में बदल दिए जाएँगे
नोट #1: Google Ads कुछ कीवर्ड समूहों के लिए कोई डेटा नहीं लौटा सकता;
नोट #2: Google Ads समान कीवर्ड समूहों के लिए संयुक्त सर्च वॉल्यूम मान प्रदान करता है
समान कीवर्ड के लिए सर्च वॉल्यूम प्राप्त करने के लिए, हम ऐसे कीवर्ड अलग-अलग रिक्वेस्ट में सबमिट करने की सलाह देते हैं;
नोट #3: Google Ads कुछ प्रतीकों और वर्णों (जैसे UTF प्रतीक, इमोजी) के उपयोग की अनुमति नहीं देता, इसलिए टास्क सेट करते समय इनका उपयोग नहीं किया जा सकता;
यह जानने के लिए कि किन प्रतीकों और वर्णों का उपयोग किया जा सकता है, यह लेख देखेंDataForSEO API में
keywordऔरkeywordsफ़ील्ड के नियमों और सीमाओं के बारे में इस Help Center लेख में जानें - languageटाइप: string | null
_code सर्च इंजन भाषा कोड
वैकल्पिक फ़ील्ड
आपlanguage_codeके साथ उपलब्ध सर्च इंजन भाषाओं की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें:https://api.dataforseo.com/v3/keywords_data/google_ads/languages
उदाहरण:en - languageटाइप: string | null
_name सर्च इंजन भाषा का पूरा नाम
वैकल्पिक फ़ील्ड
आपlanguage_nameके साथ उपलब्ध सर्च इंजन भाषाओं की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें:https://api.dataforseo.com/v3/keywords_data/google_ads/languages
उदाहरण:English - locationटाइप: integer | null
_code सर्च इंजन स्थान कोड
वैकल्पिक फ़ील्ड
यदि आप स्थान निर्दिष्ट नहीं करते हैं, तो आपको दुनिया भर के परिणाम मिलेंगे, अर्थात सभी उपलब्ध स्थानों के लिए;
यदि आप यह फ़ील्ड उपयोग करते हैं, तोlocation_nameयाlocation_coordinateनिर्दिष्ट करने की आवश्यकता नहीं है;
आपlocation_codeके साथ उपलब्ध सर्च इंजन स्थानों की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें:https://api.dataforseo.com/v3/keywords_data/google_ads/locations
उदाहरण:2840 - locationटाइप: string | null
_coordinate स्थान के GPS निर्देशांक
वैकल्पिक फ़ील्ड
यदि आप स्थान निर्दिष्ट नहीं करते हैं, तो आपको दुनिया भर के परिणाम मिलेंगे, अर्थात सभी उपलब्ध स्थानों के लिए;
यदि आप यह फ़ील्ड उपयोग करते हैं, तोlocation_nameयाlocation_codeनिर्दिष्ट करने की आवश्यकता नहीं है;location_coordinateपैरामीटर "latitude,longitude" प्रारूप में निर्दिष्ट करना चाहिए;
डेटा उस देश के लिए प्रदान किया जाएगा जिससे निर्दिष्ट निर्देशांक संबंधित हैं;
उदाहरण:52.6178549,-155.352142 - locationटाइप: string | null
_name सर्च इंजन स्थान का पूरा नाम
वैकल्पिक फ़ील्ड
यदि आप स्थान निर्दिष्ट नहीं करते हैं, तो आपको दुनिया भर के परिणाम मिलेंगे, अर्थात सभी उपलब्ध स्थानों के लिए;
यदि आप यह फ़ील्ड उपयोग करते हैं, तोlocation_codeयाlocation_coordinateनिर्दिष्ट करने की आवश्यकता नहीं है
आपlocation_nameके साथ उपलब्ध सर्च इंजन स्थानों की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें:https://api.dataforseo.com/v3/keywords_data/google_ads/locations
उदाहरण:London,England,United Kingdom - searchटाइप: boolean | null
_partners - sortटाइप: string | null
_by परिणाम सॉर्टिंग पैरामीटर
वैकल्पिक फ़ील्ड
परिणामों कोrelevance,search_volume,competition_index,low_top_of_page_bidयाhigh_top_of_page_bidके अनुसार अवरोही क्रम में सॉर्ट करने के लिए इन पैरामीटर का उपयोग करें
डिफ़ॉल्ट मान:relevance - tagटाइप: string | null
उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
वैकल्पिक फ़ील्ड
अक्षर सीमा 255 है
आप इस पैरामीटर से टास्क पहचान सकते हैं और उसे परिणाम से मिला सकते हैं
निर्दिष्टtagमान response केdataऐरे में मिलेगा
- टाइप: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeLiveResponseInfo200
- टाइप: number | null फ़ॉर्मेट: doublecost
टास्क की कुल लागत, USD
- टाइप: integer | nullstatus
_code सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है
- टाइप: string | nullstatus
_message सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- टाइप: array (object | null)[] | nulltasks
टास्क का ऐरे
- टाइप: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeLiveTaskInfo
- costटाइप: number | null फ़ॉर्मेट: double
टास्क की कुल लागत, USD
- dataटाइप: object | null
इसमें वही पैरामीटर हैं जो आपने POST request में निर्दिष्ट किए थे
- propertyटाइप: object | null
Name
- idटाइप: string | null
टास्क आइडेंटिफ़ायर हमारे सिस्टम में अद्वितीय टास्क आइडेंटिफ़ायर, UUID प्रारूप में
- pathटाइप: array (string | null)[] | null
URL पथ
- resultटाइप: array (object | null)[] | null
परिणामों का ऐरे
- competitionटाइप: string | null
- competitionटाइप: integer | null
_index - cpcटाइप: number | null
प्रति क्लिक लागत
दिए गए कीवर्ड के लिए दिखाए गए विज्ञापन पर प्रत्येक क्लिक के लिए भुगतान की गई राशि (USD) दर्शाता है - highटाइप: number | null
_top _of _page _bid पहले पेज के शीर्ष पर विज्ञापन दिखाने के लिए अधिकतम बिड
उन सबसे कम बिड के लगभग 80% से अधिक मान दर्शाता है जिन पर विज्ञापन दिखाए गए थे (विज्ञापनदाताओं के लिए Google Ads आंकड़ों पर आधारित);
POST request में निर्दिष्ट स्थान के अनुसार मान भिन्न हो सकता है - keywordटाइप: string | null
कीवर्ड
कीवर्ड डिकोड किए गए %## के साथ लौटाया जाता है (प्लस चिह्न '+' को स्पेस वर्ण में डिकोड किया जाएगा) - languageटाइप: string | null
_code POST सरणी में भाषा कोड
यदि कोई डेटा नहीं है, तो मानnullहै - locationटाइप: integer | null
_code POST सरणी में स्थान कोड
यदि कोई डेटा नहीं है, तो मानnullहै - lowटाइप: number | null
_top _of _page _bid पहले पेज के शीर्ष पर विज्ञापन दिखाने के लिए न्यूनतम बिड
उन सबसे कम बिड के लगभग 20% से अधिक मान दर्शाता है जिन पर विज्ञापन दिखाए गए थे (विज्ञापनदाताओं के लिए Google Ads आंकड़ों पर आधारित);
POST request में निर्दिष्ट स्थान के अनुसार मान भिन्न हो सकता है - monthlyटाइप: array (object | null)[] | null
_searches मासिक सर्च
निर्दिष्ट भौगोलिक स्थानों को लक्षित इस कीवर्ड आइडिया पर सर्च की (अनुमानित) संख्या दर्शाता है (जैसा डिफ़ॉल्ट रूप से पिछले बारह महीनों के लिए उपलब्ध है);
यदि कोई डेटा नहीं है, तो मानnullहै- monthटाइप: integer | null
महीना
- searchटाइप: integer | null
_volume औसत मासिक सर्च वॉल्यूम दर
- yearटाइप: integer | null
वर्ष
- searchटाइप: boolean | null
_partners दर्शाता है कि response में पार्टनर नेटवर्क का डेटा शामिल है या नहीं
- searchटाइप: integer | null फ़ॉर्मेट: int64
_volume औसत मासिक सर्च वॉल्यूम दर;
उपयोगकर्ता की टार्गेटिंग के आधार पर google.com पर या google.com और पार्टनर पर दिए गए कीवर्ड आइडिया के लिए सर्च की (अनुमानित) संख्या दर्शाता है;
यदि कोई डेटा नहीं है, तो मानnullहै - spellटाइप: string | null
- resultटाइप: integer | null फ़ॉर्मेट: int64
_count result ऐरे में एलिमेंट की संख्या
- statusटाइप: integer | null
_code टास्क का स्टेटस कोड DataForSEO द्वारा जनरेट किया गया, यह निम्न श्रेणी में हो सकता है: 10000-60000 response कोड की पूरी सूची यहाँ देखी जा सकती है
- statusटाइप: string | null
_message टास्क का सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- timeटाइप: string | null
निष्पादन समय, सेकंड
- टाइप: integer | null फ़ॉर्मेट: int64tasks
_count tasks ऐरे में टास्क की संख्या
- टाइप: integer | null फ़ॉर्मेट: int64tasks
_error त्रुटि के साथ लौटाए गए tasks ऐरे में टास्क की संख्या
- टाइप: string | nulltime
कुल निष्पादन समय, सेकंड
- टाइप: string | nullversion
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/keywords_data/google_ads/search_volume/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"location_code": 2840,
"keywords": [
"buy laptop",
"cheap laptops for sale",
"purchase laptop"
],
"date_from": "2021-08-01",
"search_partners": true
}
]'
{
"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,
"spell": null,
"location_code": null,
"language_code": null,
"search_partners": null,
"competition": null,
"competition_index": null,
"search_volume": null,
"low_top_of_page_bid": null,
"high_top_of_page_bid": null,
"cpc": null,
"monthly_searches": [
{
"year": null,
"month": null,
"search_volume": null
}
]
}
]
}
]
}