v0.2.0-beta

OpenAPI 3.1.0

ڈومین صفحات کا خلاصہ

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/backlinks/domain_pages_summary/live

ڈومین صفحات کا خلاصہ

ایک target کے لیے فی صفحہ بیک لنک میٹرکس: ہر url کے لیے ایک قطار جس میں rank، backlinks، first_seen، lost_date، backlinks_spam_score، broken_backlinks اور broken_pages ہیں۔ post_dataforseo_backlinks_summary_live کا صفحہ سطح کا جڑواں، جو پورے ڈومین کے لیے وہی میٹرکس بتاتا ہے۔ ان صفحات کے بارے میں کرال میٹا ڈیٹا کے لیے اس کے بجائے post_dataforseo_backlinks_domain_pages_live استعمال کریں۔

قیمت کا حوالہ

میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
حوالہ جاتی درخواست کا تخمینہ: USD 0.0276۔
حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔

صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔

باڈی

application/json

قسم: array (object | null)[]
- backlinks_filters
  قسم: array (object | null)[] | null
  
  اپنے target کے بیک لنکس فلٹر کریں
  اختیاری فیلڈ
  آپ یہ فیلڈ ابتدائی بیک لنکس فلٹر کرنے کے لیے استعمال کر سکتے ہیں جو آپ کے target کے مجموعی میٹرکس کے ڈیٹاسیٹ میں شامل ہوں گے
  آپ بیک لنکس کو اس endpoint کے جواب میں دستیاب تمام فیلڈز کے لحاظ سے فلٹر کر سکتے ہیں
  اس پیرامیٹر سے آپ جواب میں صرف dofollow بیک لنکس شامل کر سکتے ہیں اور میٹرکس شمار کرنے کے لیے لچکدار بیک لنکس ڈیٹاسیٹ بنا سکتے ہیں
  مثال:
  "backlinks_filters": [["dofollow", "=", true]]
  
  خالی آبجیکٹ
- backlinks_status_type
  قسم: string | null
  
  متعین کریں کہ کون سے بیک لنکس واپس اور شمار کیے جائیں
  اختیاری فیلڈ
  آپ یہ فیلڈ منتخب کرنے کے لیے استعمال کر سکتے ہیں کہ آپ کے target کے مجموعی میٹرکس کے لیے کون سے بیک لنکس واپس اور استعمال کیے جائیں؛
  ممکنہ اقدار:
  all - تمام بیک لنکس واپس اور شمار کیے جائیں گے؛
  live - آخری جانچ کے دوران ملنے والے بیک لنکس واپس اور شمار کیے جائیں گے؛
  lost - گمشدہ بیک لنکس واپس اور شمار کیے جائیں گے؛
  
  ڈیفالٹ قدر: live
- exclude_internal_backlinks
  قسم: boolean | null
  
  بتاتا ہے کہ target کے ذیلی ڈومینز سے آنے والے بیک لنکس خارج ہوں گے یا نہیں
  اختیاری فیلڈ
  اگر false پر سیٹ ہو تو target ڈومین کے ذیلی ڈومینز سے آنے والے بیک لنکس چھوڑ دیے جائیں گے اور آپ کو جواب میں وہی ڈومین موصول نہیں ہوگا؛
  ڈیفالٹ قدر: true
- filters
  قسم: array (object | null)[] | null
  
  نتائج کی فلٹرنگ پیرامیٹرز کی صف
  اختیاری فیلڈ
  آپ ایک ساتھ کئی فلٹرز شامل کر سکتے ہیں (زیادہ سے زیادہ 8 فلٹرز)
  شرائط کے درمیان آپ کو منطقی آپریٹر and، or سیٹ کرنا چاہیے
  درج ذیل آپریٹرز معاون ہیں:
  regex، not_regex، =، <>، in، not_in، like، not_like، ilike، not_ilike، match، not_match
  آپ صفر یا زیادہ حروف کی کسی بھی اسٹرنگ سے مطابقت کے لیے like اور not_like کے ساتھ % آپریٹر استعمال کر سکتے ہیں
  مثال:
  ["referring_links_types.anchors",">","1"]
  
  [["broken_pages",">","2"], "and", ["backlinks",">","10"]]
  
  [["first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["anchor","like","%seo%"],"or",["referring_domains",">","10"]]]
  
  ممکنہ فلٹرز کی مکمل فہرست یہاں دستیاب ہے۔
  
  خالی آبجیکٹ
- include_indirect_links
  قسم: boolean | null
  
  بتاتا ہے کہ target کے بالواسطہ لنکس نتائج میں شامل ہوں گے یا نہیں
  اختیاری فیلڈ
  اگر true پر سیٹ ہو تو نتائج میں ان بالواسطہ لنکس کا ڈیٹا شامل ہوگا جو ایسے صفحے کی طرف اشارہ کرتے ہیں جو یا تو target کی طرف ری ڈائریکٹ ہوتا ہے، یا کینونیکل صفحے کی طرف اشارہ کرتا ہے
  اگر false پر سیٹ ہو تو بالواسطہ لنکس نظر انداز کر دیے جائیں گے
  ڈیفالٹ قدر: true
- include_subdomains
  قسم: boolean | null
  
  بتاتا ہے کہ target ڈومین کے ذیلی ڈومینز تلاش میں شامل ہوں گے یا نہیں
  اختیاری فیلڈ
  اگر false پر سیٹ ہو تو ذیلی ڈومینز نظر انداز کر دیے جائیں گے
  ڈیفالٹ قدر: true
- internal_list_limit
  قسم: integer | null
  
  اندرونی صفوں کے اندر عناصر کی زیادہ سے زیادہ تعداد
  اختیاری فیلڈ
  آپ یہ فیلڈ درج ذیل صفوں کے اندر عناصر کی تعداد محدود کرنے کے لیے استعمال کر سکتے ہیں:
  referring_links_tld
  referring_links_types
  referring_links_attributes
  referring_links_platform_types
  referring_links_semantic_locations
  
  ڈیفالٹ قدر: 10
  زیادہ سے زیادہ قدر: 1000
- limit
  قسم: integer | null
  
  واپس کیے جانے والے اینکرز کی زیادہ سے زیادہ تعداد
  اختیاری فیلڈ
  ڈیفالٹ قدر: 100
  زیادہ سے زیادہ قدر: 1000
- offset
  قسم: integer | null
  
  واپس کیے گئے اینکرز کی نتائج صف میں آفسیٹ
  اختیاری فیلڈ
  ڈیفالٹ قدر: 0
  اگر آپ قدر 10 متعین کریں تو نتائج کی صف میں پہلے دس اینکرز چھوڑ دیے جائیں گے اور ڈیٹا اگلے اینکرز کے لیے فراہم کیا جائے گا
- order_by
  قسم: array string[] | null
  
  نتائج کی ترتیب کے قواعد
  اختیاری فیلڈ
  آپ نتائج کی ترتیب کے لیے filters صف کی طرح وہی اقدار استعمال کر سکتے ہیں
  ممکنہ ترتیب کی اقسام:
  asc - نتائج صعودی ترتیب میں ترتیب دیے جائیں گے
  desc - نتائج نزولی ترتیب میں ترتیب دیے جائیں گے
  ترتیب کی قسم مقرر کرنے کے لیے کوما استعمال کریں
  مثال:
  ["backlinks,desc"]
  نوٹ کریں کہ ایک ہی درخواست میں زیادہ سے زیادہ تین ترتیب کے قواعد مقرر کیے جا سکتے ہیں
  کئی ترتیب کے قواعد کو الگ کرنے کے لیے کوما استعمال کریں
  مثال:
  ["backlinks,desc","rank,asc"]
- rank_scale
  قسم: string | null
  
  وہ اسکیل متعین کرتا ہے جو rank، domain_from_rank اور page_from_rank اقدار کے حساب اور نمایش کے لیے استعمال ہوتا ہے
  اختیاری فیلڈ
  
  آپ یہ پیرامیٹر منتخب کرنے کے لیے استعمال کر سکتے ہیں کہ rank اقدار 0–100 یا 0–1000 اسکیل پر پیش کی جائیں
  
  ممکنہ اقدار:
  one_hundred — rank اقدار 0–100 اسکیل پر دکھائی جاتی ہیں
  one_thousand — rank اقدار 0–1000 اسکیل پر دکھائی جاتی ہیں
  
  ڈیفالٹ قدر: one_thousand
  
  اس پیرامیٹر کے کام کرنے اور رینکنگ میٹرکس کے حساب کے بارے میں اس Help Center مضمون میں مزید جانیں
- tag
  قسم: string | null
  
  صارف کے متعین کردہ ٹاسک کا شناخت کنندہ
  اختیاری فیلڈ
  حروف کی حد 255 ہے
  آپ اس پیرامیٹر سے ٹاسک کی شناخت کر سکتے ہیں اور اسے نتیجے سے ملا سکتے ہیں
  آپ جواب کے data آبجیکٹ میں متعین کردہ tag قدر دیکھیں گے
- target
  قسم: string
  
  وہ ڈومین، ذیلی ڈومین یا ویب صفحہ جس کے لیے خلاصہ ڈیٹا حاصل کیے جائے
  درکار فیلڈ
  ڈومین یا ذیلی ڈومین https:// اور www. کے بغیر متعین کرنا چاہیے
  صفحہ مطلق URL کے ساتھ متعین کرنا چاہیے (بشمول http:// یا https://)

جوابات

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

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

status_code
قسم: integer | null

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

status_message
قسم: string | null

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

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

ٹاسکس کی صف

قسم: object | null · Response36Afe1097B20_BacklinksDomainPagesSummaryLiveTaskInfo
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

آئٹمز کی صف

backlinks
قسم: integer | null فارمیٹ: int64

بیک لنکس کی تعداد

backlinks_spam_score
قسم: integer | null فارمیٹ: int64

صفحے کی طرف اشارہ کرنے والے بیک لنکس کا اوسط اسپام اسکور
اس میٹرک کے حساب کے بارے میں اس help center صفحے پر مزید جانیں

broken_backlinks
قسم: integer | null فارمیٹ: int64

ٹوٹے ہوئے بیک لنکس کی تعداد
صفحے کی طرف اشارہ کرنے والے ٹوٹے ہوئے بیک لنکس کی تعداد

broken_pages
قسم: integer | null

ٹوٹے ہوئے صفحات کی تعداد
ان صفحات کی تعداد جو 4xx یا 5xx اسٹیٹس کوڈ کے ساتھ جواب دیتے ہیں اور جن کی طرف بیک لنکس اشارہ کرتے ہیں

first_seen
قسم: string | null

وہ تاریخ و وقت جب ہمارے کرالر نے اس صفحے کا بیک لنک پہلی بار تلاش کیا
UTC فارمیٹ میں: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:
2019-11-15 12:57:46 +00:00

lost_date
قسم: string | null

وہ تاریخ و وقت جب اس صفحے کا آخری بیک لنک ختم ہوا
وہ تاریخ و وقت ظاہر کرتا ہے جب ہمارے کرالر نے صفحہ دیکھا اور اس نے 4xx یا 5xx اسٹیٹس کوڈ واپس کیا یا آخری بیک لنک ہٹا دیا گیا
UTC فارمیٹ میں: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:
2017-01-24 13:20:59 +00:00

rank
قسم: integer | null

صفحہ رینک
page کا رینک
rank کا حساب لنکڈ ڈیٹابیس میں نوڈ رینکنگ کے طریقے کی بنیاد پر کیا جاتا ہے - یہی اصول اصل Google PageRank الگورتھم میں استعمال ہوتا ہے
اس میٹرک اور اس کے حساب کے بارے میں اس help center مضمون میں مزید جانیں

referring_domains
قسم: integer | null فارمیٹ: int64

صفحے کی طرف اشارہ کرنے والے ڈومینز کی تعداد ظاہر کرتا ہے

referring_domains_nofollow
قسم: integer | null فارمیٹ: int64

page کی طرف کم از کم ایک nofollow لنک بھیجنے والے ڈومینز کی تعداد

referring_ips
قسم: integer | null فارمیٹ: int64

ریفرنگ IP پتوں کی تعداد
اس صفحہ کی طرف اشارہ کرنے والے IP پتوں کی تعداد

referring_links_attributes
قسم: object | null

ریفرنگ لنکس کی لنک خصوصیات
ریفرنگ لنکس کی لنک خصوصیات اور ہر خصوصیت کے مطابق لنک کی تعداد بتاتا ہے

propertyName
قسم: integer | null فارمیٹ: int64

Signed 64-bit integers (long type).

referring_links_countries
قسم: object | null

ریفرنگ لنکس کے ISO ملکی کوڈز
ان ڈومینز کے ISO ملکی کوڈز بتاتا ہے جہاں ریفرنگ لنکس موجود ہیں اور ہر ملک کے مطابق لنک کی تعداد

propertyName
قسم: integer | null فارمیٹ: int64

Signed 64-bit integers (long type).

referring_links_platform_types
قسم: object | null

ریفرنگ پلیٹ فارمز کی اقسام
ریفرنگ پلیٹ فارم کی اقسام اور ہر پلیٹ فارم پر لنک کی تعداد بتاتا ہے

ممکنہ قدریں: cms, blogs, ecommerce, message-boards, wikis, news, organization

propertyName
قسم: integer | null فارمیٹ: int64

Signed 64-bit integers (long type).

referring_links_semantic_locations
قسم: object | null

ریفرنگ لنکس کے سیمنٹک مقامات
HTML میں وہ سیمنٹک عناصر ظاہر کرتا ہے جہاں ریفرنگ لنکس موجود ہیں اور ہر سیمنٹک مقام کے حساب سے لنک کی تعداد

سیمنٹک عناصر کی مکمل فہرست یہاں حاصل کر سکتے ہیں
مثالیں:
article، section، footer

propertyName
قسم: integer | null فارمیٹ: int64

Signed 64-bit integers (long type).

referring_links_tld
قسم: object | null

ریفرنگ لنکس کے ٹاپ لیول ڈومینز
ٹاپ لیول ڈومینز اور ہر ایک کے مطابق ریفرنگ لنک کی تعداد رکھتا ہے

propertyName
قسم: integer | null فارمیٹ: int64

Signed 64-bit integers (long type).

referring_links_types
قسم: object | null

ریفرنگ لنکس کی اقسام
ریفرنگ لنکس کی اقسام اور ہر قسم کے مطابق لنک کی تعداد بتاتا ہے
ممکنہ قدریں:
anchor, image, link, meta, canonical, alternate, redirect

propertyName
قسم: integer | null فارمیٹ: int64

Signed 64-bit integers (long type).

referring_main_domains
قسم: integer | null فارمیٹ: int64

ریفرنگ مین ڈومینز کی تعداد بتاتا ہے

referring_main_domains_nofollow
قسم: integer | null فارمیٹ: int64

page کی طرف کم از کم ایک nofollow لنک بھیجنے والے مین ڈومینز کی تعداد

referring_pages
قسم: integer | null فارمیٹ: int64

متعلقہ url کی طرف اشارہ کرنے والے صفحات کی تعداد ظاہر کرتا ہے

referring_pages_nofollow
قسم: integer | null فارمیٹ: int64

page کی طرف کم از کم ایک nofollow لنک بھیجنے والے ریفرنگ صفحات کی تعداد

referring_subnets
قسم: integer | null فارمیٹ: int64

ریفرنگ سب نیٹ ورکس کی تعداد

type
قسم: string | null

عنصر کی قسم

url
قسم: string | null

صفحے کا URL

items_count
قسم: integer | null فارمیٹ: int64

نتائج کی صف میں آئٹمز کی تعداد

target
قسم: string | null

post صف میں ہدف

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/backlinks/domain_pages_summary/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_pages_summary/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "limit": 4,
    "order_by": [
      "backlinks,desc"
    ]
  }
]'

اسکیما دکھائیں

{
  "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": [
        {
          "target": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "url": null,
              "rank": null,
              "backlinks": null,
              "first_seen": null,
              "lost_date": null,
              "backlinks_spam_score": null,
              "broken_backlinks": null,
              "broken_pages": null,
              "referring_domains": null,
              "referring_domains_nofollow": null,
              "referring_main_domains": null,
              "referring_main_domains_nofollow": null,
              "referring_ips": null,
              "referring_subnets": null,
              "referring_pages": null,
              "referring_pages_nofollow": null,
              "referring_links_tld": null,
              "referring_links_types": null,
              "referring_links_attributes": null,
              "referring_links_platform_types": null,
              "referring_links_semantic_locations": null,
              "referring_links_countries": null
            }
          ]
        }
      ]
    }
  ]
}

کامیاب آپریشن

ڈومین صفحات کا خلاصہ

توثیقRequired

DataForSEO

ڈومین صفحات کا خلاصہ

قیمت کا حوالہ