v0.2.0-beta

OpenAPI 3.1.0

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 کے لفافے میں لپٹا: ڈیٹا tasks[0].result میں، نتیجہ tasks[0].status_code میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔ ⚠️ یہ تلاش کے کمپٹیٹرز ہیں، جو مشترکہ درجہ بندی سے طے ہوتے ہیں۔ لنک گراف کے لحاظ سے ہم منصب post_dataforseo_backlinks_competitors_live ہے، اور دونوں فہرستیں اکثر مختلف ہوتی ہیں - جو بذاتِ خود معلوماتی ہے۔

قیمت کا حوالہ

میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
حوالہ جاتی درخواست کا تخمینہ: 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
  
  تلاش کے نتائج کی قسم
  جواب میں شامل تلاش کے نتائج کی قسم بتاتا ہے
  اختیاری فیلڈ
  
  ممکنہ اقدار:
  ["organic", "paid", "featured_snippet", "local_pack"]
  ڈیفالٹ قدر:
  ["organic", "paid"]
- keywords
  قسم: array string[]
  
  کی ورڈز کی صف
  درکار فیلڈ
  نتائج اس صف میں آپ کی متعین کردہ کی ورڈز پر مبنی ہوں گے
  UTF-8 انکوڈنگ؛
  کی ورڈز کو لوئر کیس فارمیٹ میں تبدیل کر دیا جائے گا؛
  آپ زیادہ سے زیادہ 200 کی ورڈز متعین کر سکتے ہیں
  
  DataForSEO APIs میں 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 ہے
  آپ اس پیرامیٹر سے ٹاسک کی شناخت کر سکتے ہیں اور اسے نتیجے سے ملا سکتے ہیں
  آپ جواب کے data آبجیکٹ میں متعین کردہ tag قدر دیکھیں گے

جوابات

200
قسم: object | null · Response36Afe1097B20_DataforseoLabsGoogleSerpCompetitorsLiveResponseInfo
cost
قسم: number | null فارمیٹ: double

ٹاسکس کی کل لاگت، USD

status_code
قسم: integer | null

عمومی اسٹیٹس کوڈ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے

status_message
قسم: string | null

عمومی معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے

tasks
قسم: array (object | null)[] | null

ٹاسکس کی صف

قسم: object | null · Response36Afe1097B20_DataforseoLabsGoogleSerpCompetitorsLiveTaskInfo
cost
قسم: number | null فارمیٹ: double

ٹاسکس کی کل لاگت، USD

data
قسم: object | null

وہی پیرامیٹرز رکھتا ہے جو آپ نے POST درخواست میں متعین کیے۔

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

وہ متعین کردہ کی ورڈز کی تعداد جن کے لیے ڈومین کی SERPs میں پوزیشنز ہیں

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 رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے

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

درخواست پر کارروائی نہیں ہو سکی۔ درخواست کے پیرامیٹرز چیک کریں۔
401

درست Felo API کلید درکار ہے۔
402

درخواست آگے نہیں بڑھ سکتی کیونکہ بلنگ کی شرط پوری نہیں ہوئی۔
403

اکاؤنٹ کو یہ آپریشن کرنے کی اجازت نہیں۔
429

درخواست یا اخراجات کی حد پوری ہو گئی ہے۔
502

سروس درخواست مکمل نہیں کر سکی۔
503

API یا بلنگ سروس عارضی طور پر دستیاب نہیں۔
504

درخواست پر کارروائی کے دوران سروس کا وقت ختم ہو گیا۔
default

خرابی کا جواب؛ اپ اسٹریم پاس تھرو جوابات پرووائیڈر کی شکلیں استعمال کر سکتے ہیں

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 کمپٹیٹرز

قیمت کا حوالہ