id से Google Ads Search उन्नत परिणाम प्राप्त करें
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
id से Google Ads Search उन्नत परिणाम प्राप्त करें
कतार में रखा Google ads search परिणाम id से प्राप्त करता है। keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count और items लौटाता है। DataForSEO के envelope में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में — अस्वीकृत request फिर भी HTTP 200 लौटाता है।
मूल्य संदर्भ
- मीटरिंग: सफल request के निश्चित लागत आधार पर
- संदर्भ request अनुमान: USD 0.02
- संदर्भ ग्राहक गुणक: 1.0। निपटाई गई ग्राहक राशि पर इसे दोबारा लागू न करें।
यह केवल संदर्भ मेटाडेटा है — खाते का कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। रिसोर्स क्रेडिट Felo क्रेडिट नहीं हैं। अंतिम शुल्क Felo बिलिंग रिकॉर्ड के अनुसार लगते हैं।
- टाइप: object | null · Response36Afe1097B20_SerpGoogleAdsSearchTaskGetAdvancedResponseInfo200
- टाइप: number | null फ़ॉर्मेट: doublecost
टास्क की कुल लागत, USD
- टाइप: integer | nullstatus
_code सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है
- टाइप: string | nullstatus
_message सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- टाइप: array (object | null)[] | nulltasks
टास्क का ऐरे
- टाइप: object | null · Response36Afe1097B20_SerpGoogleAdsSearchTaskGetAdvancedTaskInfo
- 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
परिणामों का ऐरे
- checkटाइप: string | null
_url सर्च इंजन परिणामों का सीधा URL
इस मामले में,nullके बराबर - datetimeटाइप: string | null
वह तारीख और समय जब परिणाम प्राप्त हुआ
UTC प्रारूप में: “yyyy-mm-dd hh-mm-ss +00:00”
उदाहरण:2019-11-15 12:57:46 +00:00 - itemटाइप: array (string | null)[] | null
_types SERP में सर्च परिणामों के प्रकार
SERP में मिले सर्च परिणामों (items) के प्रकार शामिल हैं।
संभावित आइटम प्रकार:ads_search - itemsटाइप: array (object | null)[] | null
तत्व के आइटम
- advertiserटाइप: string | null
_id विज्ञापनदाता खाते का अद्वितीय आइडेंटिफ़ायर
- creativeटाइप: string | null
_id विज्ञापन का अद्वितीय आइडेंटिफ़ायर
- firstटाइप: string | null
_shown वह दिनांक और समय जब विज्ञापन पहली बार दिखाया गया
UTC प्रारूप में: “yyyy-mm-dd hh-mm-ss +00:00” - formatटाइप: string | null
विज्ञापन का प्रारूप
संभावित मान:text,image,video - lastटाइप: string | null
_shown वह दिनांक और समय जब विज्ञापन अंतिम बार दिखाया गया
UTC प्रारूप में: “yyyy-mm-dd hh-mm-ss +00:00” - previewटाइप: object | null · Response36Afe1097B20_PreviewImage
_image विज्ञापन की प्रीव्यू इमेज
- heightटाइप: integer | null
पूर्वावलोकन छवि की ऊँचाई
- urlटाइप: string | null
रिफ़ाइनमेंट पैरामीटर सहित सर्च URL
- widthटाइप: integer | null फ़ॉर्मेट: int64
पूर्वावलोकन छवि की चौड़ाई
- previewटाइप: string | null
_url विज्ञापन प्रीव्यू की ओर इंगित करने वाला url
- rankटाइप: integer | null
_absolute SERP में पूर्ण रैंक
SERP के सभी तत्वों में पूर्ण स्थिति - rankटाइप: integer | null
_group SERP में समूह रैंक
समानtypeमान वाले तत्वों के समूह के भीतर स्थिति
भिन्नtypeमान वाले तत्वों की स्थितियाँrank_groupसे बाहर रखी जाती हैं - titleटाइप: string | null
तत्व का शीर्षक
- typeटाइप: string | null
एलिमेंट का प्रकार
- urlटाइप: string | null
रिफ़ाइनमेंट पैरामीटर सहित सर्च URL
- verifiedटाइप: boolean | null
सत्यापित विज्ञापनदाता खाता
trueके बराबर यदि विज्ञापनदाता खाता Google Ads द्वारा सत्यापित है
- itemsटाइप: integer | null फ़ॉर्मेट: int64
_count itemsऐरे में लौटाए गए परिणामों की संख्या - keywordटाइप: string | null
POST ऐरे में प्राप्त कीवर्ड
कीवर्ड डिकोड किए गए %## के साथ लौटाया जाता है ('+' चिह्न एक स्पेस वर्ण में डिकोड होगा) - languageटाइप: string | null
_code POST ऐरे में भाषा कोड
- locationटाइप: integer | null
_code POST ऐरे में स्थान कोड
- refinementटाइप: object | null · Response36Afe1097B20_RefinementChipsInfo
_chips सर्च रिफ़ाइनमेंट चिप्स
- itemsटाइप: array (object | null)[] | null
तत्व के आइटम
- domainटाइप: string | null
SERP में डोमेन
- optionsटाइप: array (object | null)[] | null
आगे की खोज परिष्करण विकल्प
- domainटाइप: string | null
SERP में डोमेन
- titleटाइप: string | null
तत्व का शीर्षक
- typeटाइप: string | null
एलिमेंट का प्रकार
- urlटाइप: string | null
रिफ़ाइनमेंट पैरामीटर सहित सर्च URL
- titleटाइप: string | null
तत्व का शीर्षक
- typeटाइप: string | null
एलिमेंट का प्रकार
- urlटाइप: string | null
रिफ़ाइनमेंट पैरामीटर सहित सर्च URL
- typeटाइप: string | null
एलिमेंट का प्रकार
- xpathटाइप: string | null
तत्व का XPath
- seटाइप: string | null
_domain POST ऐरे में सर्च इंजन डोमेन
- seटाइप: integer | null फ़ॉर्मेट: int64
_results _count SERP में परिणामों की कुल संख्या
- spellटाइप: object | null · Response36Afe1097B20_SpellInfo
सर्च इंजन का ऑटोकरेक्शन
यदि सर्च इंजन ने किसी सुधारे गए कीवर्ड के लिए परिणाम दिए हैं, तो हम सर्च इंजन द्वारा सुधारा गया कीवर्ड और ऑटोकरेक्शन का प्रकार बताएँगे;
इस मामले में,nullके बराबर- keywordटाइप: string | null
सर्च इंजन ऑटोकरेक्शन के परिणामस्वरूप प्राप्त कीवर्ड परिणाम सुधारे गए कीवर्ड के लिए दिए जाएँगे
- typeटाइप: string | null
ऑटोकरेक्शन का प्रकार संभावित मान: did_you_mean, showing_results_for, no_results_found_for, including_results_for नोट: Yahoo और Yandex केवल निम्न ऑटोकरेक्शन प्रकार समर्थित करते हैं: including_results_for
- typeटाइप: 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/serp/google/ads_search/task_get/advanced/00000000-0000-0000-0000-000000000000 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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,
"type": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"spell": {
"keyword": null,
"type": null
},
"refinement_chips": {
"type": null,
"xpath": null,
"items": [
"[Max Depth Exceeded]"
]
},
"item_types": [
null
],
"se_results_count": null,
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"advertiser_id": null,
"creative_id": null,
"title": null,
"url": null,
"verified": null,
"format": null,
"preview_image": "[Max Depth Exceeded]",
"preview_url": null,
"first_shown": null,
"last_shown": null
}
]
}
]
}
]
}