DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
सबडोमेन
target के सबडोमेन और प्रत्येक का सर्च फ़ुटप्रिंट। limit, offset और offset_token से पेजिंग होती है; शुरुआती पेजों से आगे जाने पर टोकन का उपयोग करें। DataForSEO के envelope में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में — अस्वीकृत request फिर भी HTTP 200 लौटाता है। उपयोगी तब, जब किसी डोमेन का ट्रैफ़िक www के अलावा कहीं और केंद्रित हो — साइट को संभालने वाला docs या blog सबडोमेन post_dataforseo_labs_google_domain_rank_overview_live में दिखता ही नहीं।
मूल्य संदर्भ
- मीटरिंग: रिपोर्ट किया गया response लागत
- संदर्भ request अनुमान: USD 0.1356
- संदर्भ ग्राहक गुणक: 1.0। निपटाई गई ग्राहक राशि पर इसे दोबारा लागू न करें।
यह केवल संदर्भ मेटाडेटा है — खाते का कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। रिसोर्स क्रेडिट Felo क्रेडिट नहीं हैं। अंतिम शुल्क Felo बिलिंग रिकॉर्ड के अनुसार लगते हैं।
- टाइप: array (object | null)[]
- filtersटाइप: array (object | null)[] | null
परिणाम फ़िल्टरिंग पैरामीटर की सरणी
वैकल्पिक फ़ील्ड
एक साथ कई फ़िल्टर जोड़ सकते हैं (अधिकतम 8 फ़िल्टर)
शर्तों के बीचand,orलॉजिकल ऑपरेटर सेट करना चाहिए
निम्नलिखित ऑपरेटर समर्थित हैं:regex,not_regex,<,<=,>,>=,=,<>,in,not_in
उदाहरण:["metrics.paid.count",">",0][["metrics.paid.count",">",0],"and",["metrics.paid.etv",">","50"]][["metrics.organic.count",">","10"],
"and",
[["metrics.organic.pos_1","<>",0],"or",["metrics.organic.pos_2_3","<>",0]]]
फ़िल्टर के बारे में अधिक जानकारी के लिए Dataforseo Labs - Filters या इस Help Center गाइड को देखेंखाली ऑब्जेक्ट - historicalटाइप: string | null
_serp _mode डेटा संग्रह मोड
वैकल्पिक फ़ील्ड
परिणाम फ़िल्टर करने के लिए इस फ़ील्ड का उपयोग कर सकते हैं;
संभावित फ़िल्टरिंग प्रकार:live— उन SERP के लिए मेट्रिक लौटाएँ जिनमें निर्दिष्टtargetके वर्तमान में रैंकिंग परिणाम हैं;lost— उन SERP के लिए मेट्रिक लौटाएँ जिनमें निर्दिष्टtargetके पहले रैंकिंग परिणाम थे, लेकिन अंतिम जाँच के दौरान नहीं थे;all— दोनों प्रकार के SERP के लिए मेट्रिक लौटाएँ
डिफ़ॉल्ट मान:live - ignoreटाइप: boolean | null
_synonyms अत्यधिक समान कीवर्ड अनदेखे करें
वैकल्पिक फ़ील्ड
यदिtrueपर सेट है, तो केवल मुख्य कीवर्ड लौटाए जाएँगे, सभी अत्यधिक समान कीवर्ड बाहर रखे जाएँगे;
डिफ़ॉल्ट मान:false - includeटाइप: boolean | null
_clickstream _data परिणाम में clickstream-आधारित मेट्रिक्स का डेटा शामिल करें या बाहर रखें
वैकल्पिक फ़ील्ड
यदि पैरामीटरtrueपर सेट है, तो आपको response मेंclickstream_etv,clickstream_gender_distributionऔरclickstream_age_distributionफ़ील्ड clickstream डेटा के साथ मिलेंगे
डिफ़ॉल्ट मान:false
इस पैरामीटर के सक्षम होने पर आपसे रिक्वेस्ट के लिए दोगुना शुल्क लिया जाएगाclickstream-आधारित मेट्रिक्स की गणना कैसे होती है, इसके बारे में इस Help Center लेख में जानें
- itemटाइप: array string[] | null
_types आइटम प्रकार के अनुसार परिणाम दिखाएँ
वैकल्पिक फ़ील्ड
response में शामिल सर्च परिणामों का प्रकार बताता हैनोट: यदि
item_typesसरणी मेंorganicसे भिन्न आइटम प्रकार हैं, तो परिणाम सरणी में पहले आइटम प्रकार के अनुसार क्रमबद्ध होंगे; आप response में शामिल न किए गए सर्च परिणाम प्रकारों के अनुसार परिणाम सॉर्ट और फ़िल्टर नहीं कर सकेंगे;संभावित मान:
["organic", "paid", "featured_snippet", "local_pack"]
डिफ़ॉल्ट मान:["organic", "paid"] - languageटाइप: string | null
_code भाषा कोड
वैकल्पिक फ़ील्ड
यदि आप यह फ़ील्ड उपयोग करते हैं, तोlanguage_nameनिर्दिष्ट करने की आवश्यकता नहीं है
आपlanguage_codeके साथ उपलब्ध भाषाओं की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें:https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
सभी उपलब्ध भाषाओं के परिणाम पाने के लिए इस फ़ील्ड को अनदेखा करें
उदाहरण:en - languageटाइप: string | null
_name भाषा का पूरा नाम
वैकल्पिक फ़ील्ड
यदि आप यह फ़ील्ड उपयोग करते हैं, तोlanguage_codeनिर्दिष्ट करने की आवश्यकता नहीं है
आपlanguage_nameके साथ उपलब्ध भाषाओं की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें:https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
सभी उपलब्ध भाषाओं के परिणाम पाने के लिए इस फ़ील्ड को अनदेखा करें
उदाहरण:English - limitटाइप: integer | null
लौटाए गए कीवर्ड की अधिकतम संख्या
वैकल्पिक फ़ील्ड
डिफ़ॉल्ट मान:100
अधिकतम मान:1000 - locationटाइप: integer | null
_code स्थान कोड
वैकल्पिक फ़ील्ड
यदि आप यह फ़ील्ड उपयोग करते हैं, तोlocation_nameनिर्दिष्ट करने की आवश्यकता नहीं है
आपlocation_codeके साथ उपलब्ध स्थानों की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें:https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
सभी उपलब्ध स्थानों के परिणाम पाने के लिए इस फ़ील्ड को अनदेखा करें
उदाहरण:2840 - locationटाइप: string | null
_name स्थान का पूरा नाम
वैकल्पिक फ़ील्ड
यदि आप यह फ़ील्ड उपयोग करते हैं, तोlocation_codeनिर्दिष्ट करने की आवश्यकता नहीं है
आपlocation_nameके साथ उपलब्ध स्थानों की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें:https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
सभी उपलब्ध स्थानों के परिणाम पाने के लिए इस फ़ील्ड को अनदेखा करें
उदाहरण:United Kingdom - offsetटाइप: integer | null
लौटाए गए कीवर्ड की परिणाम सरणी में ऑफ़सेट
वैकल्पिक फ़ील्ड
डिफ़ॉल्ट मान:0
यदि आप10मान निर्दिष्ट करते हैं, तो परिणाम सरणी में पहले दस कीवर्ड छोड़ दिए जाएँगे और डेटा अगले कीवर्ड के लिए दिया जाएगा - orderटाइप: array string[] | null
_by परिणाम सॉर्टिंग नियम
वैकल्पिक फ़ील्ड
परिणाम सॉर्ट करने के लिएfiltersसरणी जैसे ही मान उपयोग कर सकते हैं
संभावित सॉर्टिंग प्रकार:asc- परिणाम आरोही क्रम में सॉर्ट किए जाएँगेdesc- परिणाम अवरोही क्रम में सॉर्ट किए जाएँगे
सॉर्टिंग प्रकार निर्दिष्ट करने के लिए कॉमा उपयोग करना चाहिए
उदाहरण:["metrics.paid.etv,asc"]
नोट: एक ही रिक्वेस्ट में तीन से अधिक सॉर्टिंग नियम सेट नहीं कर सकते
कई सॉर्टिंग नियमों को अलग करने के लिए कॉमा उपयोग करना चाहिए
उदाहरण:["metrics.organic.etv,desc","metrics.paid.count,asc"]डिफ़ॉल्ट नियम:
["metrics.organic.count,desc"]
नोट: यदिitem_typesसरणी मेंorganicसे भिन्न आइटम प्रकार हैं, तो परिणाम सरणी में पहले आइटम प्रकार के अनुसार क्रमबद्ध होंगे - tagटाइप: string | null
उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
वैकल्पिक फ़ील्ड
अक्षर सीमा 255 है
आप इस पैरामीटर से टास्क पहचान सकते हैं और उसे परिणाम से मिला सकते हैं
निर्दिष्टtagमान response केdataऑब्जेक्ट में मिलेगा - targetटाइप: string
डोमेन
आवश्यक फ़ील्ड
लक्ष्य वेबसाइट का डोमेन नाम
डोमेनhttps://औरwww.के बिना निर्दिष्ट किया जाना चाहिए
- टाइप: object | null · Response36Afe1097B20_DataforseoLabsGoogleSubdomainsLiveResponseInfo200
- टाइप: number | null फ़ॉर्मेट: doublecost
टास्क की कुल लागत, USD
- टाइप: integer | nullstatus
_code सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है
- टाइप: string | nullstatus
_message सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- टाइप: array (object | null)[] | nulltasks
टास्क का ऐरे
- टाइप: object | null · Response36Afe1097B20_DataforseoLabsGoogleSubdomainsLiveTaskInfo
- 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
परिणामों का ऐरे
- itemsटाइप: array (object | null)[] | null
सबडोमेन और संबंधित डेटा शामिल है
- metricsटाइप: object | null
सबडोमेन से संबंधित रैंकिंग डेटा
- propertyटाइप: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
Name - clickstreamटाइप: object | null
_age _distribution - propertyटाइप: integer | null फ़ॉर्मेट: int64
Name Signed 64-bit integers (long type).
- clickstreamटाइप: number | null फ़ॉर्मेट: double
_etv clickstream डेटा पर आधारित अनुमानित ट्रैफ़िक वॉल्यूम
डोमेन जिन सभी कीवर्ड पर रैंक करता है, उनके क्लिक-थ्रू रेट और clickstream सर्च वॉल्यूम मानों के गुणनफल के रूप में गणना की जाती है
इस फ़ील्ड के परिणाम प्राप्त करने के लिए पैरामीटरinclude_clickstream_dataकोtrueपर सेट करना होगा
मेट्रिक की गणना कैसे होती है, इस बारे में इस Help Center लेख में और जानें - clickstreamटाइप: object | null
_gender _distribution - propertyटाइप: integer | null फ़ॉर्मेट: int64
Name Signed 64-bit integers (long type).
- countटाइप: integer | null फ़ॉर्मेट: int64
उन ऑर्गेनिक SERP की कुल संख्या जिनमें डोमेन या सबडोमेन शामिल है
- estimatedटाइप: number | null
_paid _traffic _cost ऑर्गेनिक सर्च ट्रैफ़िक को पेड में बदलने की अनुमानित लागत
उस श्रेणी के सभी कीवर्ड के लिए विज्ञापन चलाने की अनुमानित मासिक लागत (USD) दर्शाता है जिन पर डोमेन या सबडोमेन रैंक करता है
मेट्रिक की गणना ऑर्गेनिकetvऔर पेडcpcमानों के गुणनफल के रूप में की जाती है और यह Google Search में PPC विज्ञापन के ज़रिए अनुमानित मासिक ऑर्गेनिक ट्रैफ़िक की मात्रा लाने की लागत दर्शाती है
मेट्रिक की गणना कैसे होती है, इस बारे में इस Help Center लेख में और जानें - etvटाइप: number | null
- isटाइप: integer | null
_down रैंक नीचे गया
संकेतित लक्ष्य के कितने रैंक किए गए तत्व नीचे गए, यह दर्शाता है - isटाइप: integer | null
_lost खोए हुए रैंक किए गए तत्व
संकेतित लक्ष्य के कितने रैंक किए गए तत्व पहले SERP में मौजूद थे, लेकिन अंतिम जाँच के दौरान नहीं मिले, यह दर्शाता है - isटाइप: integer | null
_new नए रैंक किए गए तत्वों की संख्या
संकेतित लक्ष्य के लिए कितने नए रैंक किए गए तत्व मिले, यह दर्शाता है - isटाइप: integer | null
_up रैंक ऊपर गया
संकेतित लक्ष्य के कितने रैंक किए गए तत्व ऊपर गए, यह दर्शाता है - posटाइप: integer | null
_1 उन ऑर्गेनिक SERP की संख्या जहाँ डोमेन या सबडोमेन #1 पर रैंक करता है
- posटाइप: integer | null
_11 _20 उन ऑर्गेनिक SERP की संख्या जहाँ डोमेन या सबडोमेन #11-20 पर रैंक करता है
- posटाइप: integer | null
_2 _3 उन ऑर्गेनिक SERP की संख्या जहाँ डोमेन या सबडोमेन #2-3 पर रैंक करता है
- posटाइप: integer | null
_21 _30 उन ऑर्गेनिक SERP की संख्या जहाँ डोमेन या सबडोमेन #21-30 पर रैंक करता है
- posटाइप: integer | null
_31 _40 उन ऑर्गेनिक SERP की संख्या जहाँ डोमेन या सबडोमेन #31-40 पर रैंक करता है
- posटाइप: integer | null
_4 _10 उन ऑर्गेनिक SERP की संख्या जहाँ डोमेन या सबडोमेन #4-10 पर रैंक करता है
- posटाइप: integer | null
_41 _50 उन ऑर्गेनिक SERP की संख्या जहाँ डोमेन या सबडोमेन #41-50 पर रैंक करता है
- posटाइप: integer | null
_51 _60 उन ऑर्गेनिक SERP की संख्या जहाँ डोमेन या सबडोमेन #51-60 पर रैंक करता है
- posटाइप: integer | null
_61 _70 उन ऑर्गेनिक SERP की संख्या जहाँ डोमेन या सबडोमेन #61-70 पर रैंक करता है
- posटाइप: integer | null
_71 _80 उन ऑर्गेनिक SERP की संख्या जहाँ डोमेन या सबडोमेन #71-80 पर रैंक करता है
- posटाइप: integer | null
_81 _90 उन ऑर्गेनिक SERP की संख्या जहाँ डोमेन या सबडोमेन #81-90 पर रैंक करता है
- posटाइप: integer | null
_91 _100 उन ऑर्गेनिक SERP की संख्या जहाँ डोमेन या सबडोमेन #91-100 पर रैंक करता है
- seटाइप: string | null
_type सर्च इंजन का प्रकार
- subdomainटाइप: string | null
लौटाया गया सबडोमेन
- itemsटाइप: integer | null फ़ॉर्मेट: int64
_count itemsऐरे में लौटाए गए परिणामों की संख्या - languageटाइप: string | null
_code POST ऐरे में भाषा कोड
- locationटाइप: integer | null
_code POST ऐरे में स्थान कोड
- seटाइप: string | null
_type सर्च इंजन का प्रकार
- targetटाइप: string | null
POST सरणी में डोमेन
- totalटाइप: integer | null फ़ॉर्मेट: int64
_count आपके request से संबंधित हमारे डेटाबेस में परिणामों की कुल संख्या
- 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/dataforseo_labs/google/subdomains/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "dataforseo.com",
"language_name": "English",
"location_code": 2840,
"filters": [
[
"metrics.organic.pos_1",
"<>",
0
],
"or",
[
"metrics.organic.pos_2_3",
"<>",
0
]
]
}
]'
{
"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": [
{
"se_type": null,
"target": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"subdomain": null,
"metrics": null
}
]
}
]
}
]
}