‘Ad Traffic By Keywords’ टास्क सेट करें

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

‘Ad Traffic By Keywords’ टास्क सेट करें

दिए गए bid और match प्रकार पर keywords के लिए क्लिक, इम्प्रेशन और खर्च का पूर्वानुमान कतार में डालता है और टास्क id लौटाता है। search_partners में Google का पार्टनर नेटवर्क शामिल है। DataForSEO के envelope में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में — अस्वीकृत request भी HTTP 200 ही लौटाता है। यहाँ Google Ads का यही एकमात्र endpoint है जिसका कोई लाइव रूपांतर नहीं — पूर्वानुमान हमेशा कतार में जाता है। get_dataforseo_keywords_gads_ad_traffic_fetch से प्राप्त करें।

मूल्य संदर्भ

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

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

बॉडी

application/json

टाइप: array (object | null)[]
- bid
  टाइप: number
  
  अधिकतम कस्टम बोली
  आवश्यक फ़ील्ड
  एकत्र किया गया डेटा इस मान पर आधारित होगा
  यह उस कीमत को दर्शाता है जो आप किसी विज्ञापन के लिए देने को तैयार हैं; यहाँ जितना अधिक मान निर्दिष्ट करेंगे, लौटाए गए मेट्रिक्स में उतने ही अधिक मान मिलेंगे
  अधिक जानें इस Help Center लेख में
- date_from
  टाइप: string
  
  पूर्वानुमान समय सीमा की प्रारंभ तिथि
  date_to निर्दिष्ट करने पर आवश्यक फ़ील्ड
  यदि आप date_from और date_to निर्दिष्ट करते हैं, तो date_interval निर्दिष्ट करने की आवश्यकता नहीं है
  न्यूनतम मान कल की तिथि है
  date_from में निर्दिष्ट मान date_to से आगे नहीं होना चाहिए
  तिथि प्रारूप: "yyyy-mm-dd"
  उदाहरण:
  "2021-10-30" यदि Status endpoint actual_data फ़ील्ड में false लौटाता है, तो date_from को पिछले महीने से पहले के महीने और उससे पहले पर सेट किया जा सकता है;
  यदि Status endpoint actual_data फ़ील्ड में true लौटाता है, तो date_from को पिछले महीने और उससे पहले पर सेट किया जा सकता है
- date_interval
  टाइप: string | null
  
  पूर्वानुमान तिथि अंतराल
  वैकल्पिक फ़ील्ड
  यदि आप date_interval निर्दिष्ट करते हैं, तो date_from और date_to निर्दिष्ट करने की आवश्यकता नहीं है
  संभावित मान: next_week, next_month, next_quarter
  डिफ़ॉल्ट मान: next_month
- date_to
  टाइप: string
  
  पूर्वानुमान समय सीमा की समाप्ति तिथि
  date_from निर्दिष्ट करने पर आवश्यक फ़ील्ड
  यदि आप date_from और date_to निर्दिष्ट करते हैं, तो date_interval निर्दिष्ट करने की आवश्यकता नहीं है
  न्यूनतम मान date_from +1 दिन है
  अधिकतम मान अगले वर्ष का वर्तमान दिन और महीना है
  तिथि प्रारूप: "yyyy-mm-dd"
  उदाहरण:
  "2022-10-30"
- keywords
  टाइप: array string[]
  
  कीवर्ड
  आवश्यक फ़ील्ड
  आप अधिकतम कितने कीवर्ड निर्दिष्ट कर सकते हैं: 1000
  प्रत्येक कीवर्ड के लिए अधिकतम वर्ण: 80
  प्रत्येक कीवर्ड वाक्यांश के लिए अधिकतम शब्द: 10
  आपके द्वारा निर्दिष्ट कीवर्ड lowercase प्रारूप में बदल दिए जाएँगे
  नोट #1: Google Ads कुछ कीवर्ड समूहों के लिए कोई डेटा नहीं लौटा सकता;
  नोट #2: Google Ads समान कीवर्ड समूहों के लिए संयुक्त सर्च वॉल्यूम मान प्रदान करता है
  समान कीवर्ड के लिए सर्च वॉल्यूम प्राप्त करने के लिए, हम ऐसे कीवर्ड अलग-अलग रिक्वेस्ट में सबमिट करने की सलाह देते हैं;
  नोट #3: Google Ads कुछ प्रतीकों और वर्णों (जैसे UTF प्रतीक, इमोजी) के उपयोग की अनुमति नहीं देता, इसलिए टास्क सेट करते समय इनका उपयोग नहीं किया जा सकता;
  यह जानने के लिए कि किन प्रतीकों और वर्णों का उपयोग किया जा सकता है, यह लेख देखें
  
  DataForSEO API में keyword और keywords फ़ील्ड के नियमों और सीमाओं के बारे में इस Help Center लेख में जानें
- language_code
  टाइप: string | null
  
  सर्च इंजन भाषा कोड
  वैकल्पिक फ़ील्ड
  आप language_code के साथ उपलब्ध सर्च इंजन भाषाओं की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें: https://api.dataforseo.com/v3/keywords_data/google_ads/languages
  उदाहरण:
  en
- language_name
  टाइप: string | null
  
  सर्च इंजन भाषा का पूरा नाम
  वैकल्पिक फ़ील्ड
  आप language_name के साथ उपलब्ध सर्च इंजन भाषाओं की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें: https://api.dataforseo.com/v3/keywords_data/google_ads/languages
  उदाहरण:
  English
- location_code
  टाइप: integer | null
  
  सर्च इंजन स्थान कोड
  वैकल्पिक फ़ील्ड
  यदि आप स्थान निर्दिष्ट नहीं करते हैं, तो आपको दुनिया भर के परिणाम मिलेंगे, अर्थात सभी उपलब्ध स्थानों के लिए;
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_name या location_coordinate निर्दिष्ट करने की आवश्यकता नहीं है;
  आप location_code के साथ उपलब्ध सर्च इंजन स्थानों की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें: https://api.dataforseo.com/v3/keywords_data/google_ads/locations
  उदाहरण:
  2840
- location_coordinate
  टाइप: string | null
  
  स्थान के GPS निर्देशांक
  वैकल्पिक फ़ील्ड
  यदि आप स्थान निर्दिष्ट नहीं करते हैं, तो आपको दुनिया भर के परिणाम मिलेंगे, अर्थात सभी उपलब्ध स्थानों के लिए;
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_name या location_code निर्दिष्ट करने की आवश्यकता नहीं है;
  location_coordinate पैरामीटर "latitude,longitude" प्रारूप में निर्दिष्ट करना चाहिए;
  डेटा उस देश के लिए प्रदान किया जाएगा जिससे निर्दिष्ट निर्देशांक संबंधित हैं;
  उदाहरण:
  52.6178549,-155.352142
- location_name
  टाइप: string | null
  
  सर्च इंजन स्थान का पूरा नाम
  वैकल्पिक फ़ील्ड
  यदि आप स्थान निर्दिष्ट नहीं करते हैं, तो आपको दुनिया भर के परिणाम मिलेंगे, अर्थात सभी उपलब्ध स्थानों के लिए;
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_code या location_coordinate निर्दिष्ट करने की आवश्यकता नहीं है
  आप location_name के साथ उपलब्ध सर्च इंजन स्थानों की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें: https://api.dataforseo.com/v3/keywords_data/google_ads/locations
  उदाहरण:
  London,England,United Kingdom
- match
  टाइप: string
  
  कीवर्ड मैच-टाइप
  आवश्यक फ़ील्ड
  यह निम्न मान ले सकता है: exact, broad, phrase
- 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 पर और जानें
- sort_by
  टाइप: string | null
  
  परिणाम सॉर्टिंग पैरामीटर
  वैकल्पिक फ़ील्ड
  परिणामों को relevance, average_cpc, cost या clicks के अनुसार अवरोही क्रम में सॉर्ट करने के लिए इन पैरामीटर का उपयोग करें
  डिफ़ॉल्ट मान: relevance
- tag
  टाइप: string | null
  
  उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
  वैकल्पिक फ़ील्ड
  अक्षर सीमा 255 है
  आप इस पैरामीटर से टास्क पहचान सकते हैं और उसे परिणाम से मिला सकते हैं
  निर्दिष्ट tag मान response के data ऑब्जेक्ट में मिलेगा

responses

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

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

status_code
टाइप: integer | null

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

status_message
टाइप: string | null

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

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

टास्क का ऐरे

टाइप: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostTaskInfo
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/google_ads/ad_traffic_by_keywords/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "bid": 999,
    "match": "exact",
    "keywords": [
      "seo marketing"
    ]
  }
]'

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

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

सफल ऑपरेशन

‘Ad Traffic By Keywords’ टास्क सेट करें

प्रमाणीकरणRequired

DataForSEO

‘Ad Traffic By Keywords’ टास्क सेट करें

मूल्य संदर्भ