SERP प्रतिस्पर्धी

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/dataforseo_labs/google/serp_competitors/live

SERP प्रतिस्पर्धी

किसी keywords समूह के लिए आपके साथ रैंक करने वाले डोमेन, और उनके साझा कीवर्ड की संख्या। se_type, seed_keywords, total_count, items_count और items लौटाता है। DataForSEO के envelope में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में — अस्वीकृत request फिर भी HTTP 200 लौटाता है। ⚠️ ये सर्च प्रतिस्पर्धी हैं, जो साझा रैंकिंग से तय होते हैं। लिंक-ग्राफ़ वाला समकक्ष post_dataforseo_backlinks_competitors_live है, और दोनों सूचियाँ अक्सर मेल नहीं खातीं — जो अपने आप में जानकारीपूर्ण है।

मूल्य संदर्भ

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

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

बॉडी

application/json

टाइप: array (object | null)[]
- filters
  टाइप: array (object | null)[] | null
  
  परिणाम फ़िल्टरिंग पैरामीटर की सरणी
  वैकल्पिक फ़ील्ड
  एक साथ कई फ़िल्टर जोड़ सकते हैं (अधिकतम 8 फ़िल्टर)
  शर्तों के बीच and, or लॉजिकल ऑपरेटर सेट करना चाहिए
  निम्नलिखित ऑपरेटर समर्थित हैं:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like, not_like
  शून्य या अधिक अक्षरों वाले किसी भी स्ट्रिंग से मिलान के लिए % ऑपरेटर को like और not_like के साथ, तथा ilike और not_ilike के साथ उपयोग कर सकते हैं
  उदाहरण:
  ["median_position","in",[1,10]]
  
  [["median_position","in",[1,10]],"and",["domain","not_like","%wikipedia.org%"]]
  
  [["domain","not_like","%wikipedia.org%"], "and", [["relevant_serp_items",">",0],"or",["median_position","in",[1,10]]]]
  फ़िल्टर के बारे में अधिक जानकारी के लिए Dataforseo Labs - Filters या इस Help Center गाइड को देखें
  
  खाली ऑब्जेक्ट
- include_subdomains
  टाइप: boolean | null
  
  बताता है कि सर्च में सबडोमेन शामिल होंगे या नहीं
  वैकल्पिक फ़ील्ड
  यदि false पर सेट है, तो सबडोमेन अनदेखे किए जाएँगे
  डिफ़ॉल्ट मान: true
- item_types
  टाइप: array string[] | null
  
  सर्च परिणाम प्रकार
  response में शामिल सर्च परिणामों का प्रकार बताता है
  वैकल्पिक फ़ील्ड
  
  संभावित मान:
  ["organic", "paid", "featured_snippet", "local_pack"]
  डिफ़ॉल्ट मान:
  ["organic", "paid"]
- keywords
  टाइप: array string[]
  
  कीवर्ड सरणी
  आवश्यक फ़ील्ड
  परिणाम इस सरणी में आपके द्वारा निर्दिष्ट कीवर्ड पर आधारित होंगे
  UTF-8 एन्कोडिंग;
  कीवर्ड को lowercase प्रारूप में बदल दिया जाएगा;
  आप अधिकतम 200 कीवर्ड निर्दिष्ट कर सकते हैं
  
  DataForSEO API में keyword और keywords फ़ील्ड के नियमों और सीमाओं के बारे में इस Help Center लेख में जानें
- language_code
  टाइप: string | null
  
  भाषा का अद्वितीय आइडेंटिफ़ायर
  आवश्यक फ़ील्ड, यदि आप निर्दिष्ट नहीं करते language_name
  नोट: language_name या language_code में से एक निर्दिष्ट करना आवश्यक है
  आप language_code पैरामीटर के साथ उपलब्ध भाषाओं की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें:
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  उदाहरण:
  en
- language_name
  टाइप: string
  
  भाषा का पूरा नाम
  आवश्यक फ़ील्ड, यदि आप निर्दिष्ट नहीं करते language_code
  नोट: language_name या language_code में से एक निर्दिष्ट करना आवश्यक है
  आप language_name पैरामीटर के साथ उपलब्ध भाषाओं की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें:
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  उदाहरण:
  English
- limit
  टाइप: integer | null
  
  लौटाए जाने वाले डोमेन की अधिकतम संख्या
  वैकल्पिक फ़ील्ड
  डिफ़ॉल्ट मान: 100
  अधिकतम मान: 1000
- location_code
  टाइप: integer
  
  स्थान का अद्वितीय आइडेंटिफ़ायर
  आवश्यक फ़ील्ड, यदि आप निर्दिष्ट नहीं करते location_name
  नोट: location_name या location_code में से एक निर्दिष्ट करना आवश्यक है
  आप location_code पैरामीटर के साथ उपलब्ध स्थानों की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें:
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  उदाहरण:
  2840
- location_name
  टाइप: string
  
  स्थान का पूरा नाम
  आवश्यक फ़ील्ड, यदि आप निर्दिष्ट नहीं करते location_code
  नोट: location_name या location_code में से एक निर्दिष्ट करना आवश्यक है
  आप location_name पैरामीटर के साथ उपलब्ध स्थानों की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें:
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  उदाहरण:
  United Kingdom
- offset
  टाइप: integer | null
  
  लौटाए गए डोमेन की परिणाम सरणी में ऑफ़सेट
  वैकल्पिक फ़ील्ड
  डिफ़ॉल्ट मान: 0
  यदि आप 10 मान निर्दिष्ट करते हैं, तो परिणाम सरणी में पहले दस डोमेन छोड़ दिए जाएँगे और डेटा अगले डोमेन के लिए प्रदान किया जाएगा
- order_by
  टाइप: array string[] | null
  
  परिणाम सॉर्टिंग नियम
  वैकल्पिक फ़ील्ड
  परिणाम सॉर्ट करने के लिए filters सरणी जैसे ही मान उपयोग कर सकते हैं
  संभावित सॉर्टिंग प्रकार:
  asc - परिणाम आरोही क्रम में सॉर्ट किए जाएँगे
  desc - परिणाम अवरोही क्रम में सॉर्ट किए जाएँगे
  विरामक के रूप में कॉमा उपयोग होता है
  उदाहरण:
  ["avg_position,asc"]
  डिफ़ॉल्ट नियम:
  ["rating,desc"]
  ध्यान दें कि एक ही रिक्वेस्ट में तीन से अधिक सॉर्टिंग नियम सेट नहीं कर सकते
  कई सॉर्टिंग नियमों को अलग करने के लिए कॉमा उपयोग करना चाहिए
  उदाहरण:
  ["avg_position,asc","etv,desc"]
- tag
  टाइप: string | null
  
  उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
  वैकल्पिक फ़ील्ड
  अक्षर सीमा 255 है
  आप इस पैरामीटर से टास्क पहचान सकते हैं और उसे परिणाम से मिला सकते हैं
  निर्दिष्ट tag मान response के data ऑब्जेक्ट में मिलेगा

responses

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

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

status_code
टाइप: integer | null

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

status_message
टाइप: string | null

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

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

टास्क का ऐरे

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

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

data
टाइप: object | null

इसमें वही पैरामीटर हैं जो आपने POST request में निर्दिष्ट किए थे

propertyName
टाइप: object | null
id
टाइप: string | null

टास्क आइडेंटिफ़ायर हमारे सिस्टम में अद्वितीय टास्क आइडेंटिफ़ायर, UUID प्रारूप में

path
टाइप: array (string | null)[] | null

URL पथ

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

परिणामों का ऐरे

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

पहचाने गए SERP प्रतिस्पर्धियों और संबंधित डेटा शामिल है

avg_position
टाइप: number | null फ़ॉर्मेट: float

निर्दिष्ट कीवर्ड के लिए डोमेन की औसत स्थिति
keywords_positions सरणी में मानों का अंकगणितीय माध्य

domain
टाइप: string | null

पहचाने गए SERP प्रतिस्पर्धी का डोमेन नाम

etv
टाइप: number | null

अनुमानित ट्रैफ़िक वॉल्यूम
निर्दिष्ट कीवर्ड वेबसाइट पर जो अनुमानित मासिक ट्रैफ़िक लाते हैं उसे दर्शाता है
SERP में निश्चित स्थितियों पर निर्दिष्ट कीवर्ड के सर्च वॉल्यूम मानों और CTR (क्लिक-थ्रू रेट) दरों के गुणनफल के योग के रूप में गणना की जाती है
मेट्रिक की गणना कैसे होती है, इस बारे में इस Help Center लेख में और जानें

keywords_count
टाइप: integer | null फ़ॉर्मेट: int64

उन निर्दिष्ट कीवर्ड की संख्या जिनके लिए डोमेन की SERP में स्थिति है

keywords_positions
टाइप: object | null

कीवर्ड स्थितियाँ
निर्दिष्ट कीवर्ड के लिए संबंधित डोमेन की SERP में मौजूद स्थितियाँ

propertyName
टाइप: array (integer | null)[] | null
median_position
टाइप: number | null

निर्दिष्ट कीवर्ड के लिए डोमेन की माध्यिका स्थिति
keywords_positions सरणी में मानों की माध्यिका

rating
टाइप: number | null

अधिकतम संभव और वास्तविक कीवर्ड स्थितियों के बीच का अंतर
निर्दिष्ट कीवर्ड के लिए SERP में डोमेन की सापेक्ष दृश्यता दर दर्शाता है
sum(100-keywords_positions) के रूप में गणना की जाती है

relevant_serp_items
टाइप: integer | null

डोमेन से संबंधित SERP तत्वों की संख्या
निर्दिष्ट कीवर्ड के लिए डोमेन से संबंधित SERP में खोज परिणामों की संख्या दर्शाता है

se_type
टाइप: string | null

सर्च इंजन का प्रकार

visibility
टाइप: number | null

SERP दृश्यता दर
निर्दिष्ट कीवर्ड की SERP स्थितियों के आधार पर वेबसाइट की दृश्यता दर दर्शाता है
1 से 10 की सीमा में स्थिति वाले कीवर्ड को क्रमशः 1 से 0.1 तक दृश्यता सूचकांक दिया जाता है
11 से 20 की सीमा में स्थिति वाले कीवर्ड का दृश्यता सूचकांक 0.05 तय है
20 से 100 तक की स्थिति वाले कीवर्ड का दृश्यता सूचकांक 0 है

items_count
टाइप: integer | null फ़ॉर्मेट: int64

items ऐरे में लौटाए गए परिणामों की संख्या

language_code
टाइप: string | null

POST सरणी में भाषा कोड
यदि कोई डेटा नहीं है, तो मान null है

location_code
टाइप: integer | null

POST सरणी में स्थान कोड
यदि कोई डेटा नहीं है, तो मान null है

se_type
टाइप: string | null

सर्च इंजन का प्रकार

seed_keywords
टाइप: array (string | null)[] | null

अनुरोध में निर्दिष्ट कीवर्ड
कीवर्ड डिकोड किए गए %## के साथ लौटाया जाता है ('+' वर्ण एक स्पेस वर्ण में डिकोड होगा)

total_count
टाइप: integer | null फ़ॉर्मेट: int64

हमारे डेटाबेस में आपके अनुरोध से संबंधित परिणामों की कुल संख्या

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/dataforseo_labs/google/serp_competitors/live

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/serp_competitors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "phone"
    ],
    "language_name": "English",
    "location_code": 2840,
    "item_types": [
      "organic"
    ],
    "limit": 5
  }
]'

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

{
  "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,
          "seed_keywords": [
            null
          ],
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "domain": null,
              "avg_position": null,
              "median_position": null,
              "rating": null,
              "etv": null,
              "keywords_count": null,
              "visibility": null,
              "relevant_serp_items": null,
              "keywords_positions": null
            }
          ]
        }
      ]
    }
  ]
}

सफल ऑपरेशन

SERP प्रतिस्पर्धी

प्रमाणीकरणRequired

DataForSEO

SERP प्रतिस्पर्धी

मूल्य संदर्भ