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/referring_domains/live

ریفرنگ ڈومینز

وہ ڈومینز جو ایک target سے لنک کرتے ہیں، ہر ڈومین کے لیے ایک قطار جس میں domain، rank، backlinks، first_seen، lost_date، backlinks_spam_score، broken_backlinks اور broken_pages ہیں۔ ریفرنگ ڈومینز خام بیک لنک گنتی سے زیادہ اہم ہیں، کیونکہ ایک ڈومین سے ہزار لنکس ایک ہی تعلق ہے۔ انفرادی لنکس کے لیے post_dataforseo_backlinks_backlinks_live استعمال کریں؛ مزید سمٹا کر نیٹ ورک آپریٹرز تک لے جانے کے لیے post_dataforseo_backlinks_referring_networks_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، match، not_match
  آپ صفر یا زیادہ حروف کی کسی بھی اسٹرنگ سے مطابقت کے لیے like اور not_like کے ساتھ % آپریٹر استعمال کر سکتے ہیں
  مثال:
  ["referring_pages",">","1"]
  
  [["referring_pages",">","2"], "and", ["backlinks",">","10"]]
  
  [["first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["domain","like","%dataforseo.com%"],"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
  
  وہ ڈومین، ذیلی ڈومین یا ویب صفحہ جس کے لیے referring domains حاصل کیے جائیں
  درکار فیلڈ
  ڈومین یا ذیلی ڈومین https:// اور www. کے بغیر متعین کرنا چاہیے
  صفحہ مطلق URL کے ساتھ متعین کرنا چاہیے (بشمول http:// یا https://)

جوابات

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

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

status_code
قسم: integer | null

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

status_message
قسم: string | null

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

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

ٹاسکس کی صف

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

target کی طرف اشارہ کرنے والے بیک لنکس کی تعداد بتاتا ہے

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

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

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

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

broken_pages
قسم: integer | null

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

domain
قسم: string | null

ریفرنگ ڈومین

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

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

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

ریفرنگ ڈومینز کی تعداد بتاتا ہے
نوٹ کریں کہ ہم اس میٹرک کے لیے مین ڈومینز (روٹ ڈومینز، جیسے example.com) اور ان کے ذیلی ڈومینز (مثلاً blog.example.com) الگ الگ شمار کرتے ہیں

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

ان ڈومینز کی تعداد جو target کی طرف کم از کم ایک 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, summary

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

ان مین ڈومینز کی تعداد جو target کی طرف کم از کم ایک nofollow لنک اشارہ کرتے ہیں

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

متعین کردہ target کی طرف اشارہ کرنے والے صفحات کی تعداد بتاتا ہے

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

ان ریفرنگ صفحات کی تعداد جو target کی طرف کم از کم ایک nofollow لنک اشارہ کرتے ہیں

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

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

type
قسم: string | null

عنصر کی قسم

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

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

target
قسم: string | null

POST صف میں target

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

ڈیٹا بیس میں متعلقہ آئٹمز کی کل تعداد
آپ کے ہدف کی طرف اشارہ کرنے والے مین ڈومینز کی کل تعداد؛
example.com اور blog.example.com کو ایک ریفرنگ ڈومین شمار کیا جاتا ہے

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/referring_domains/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/referring_domains/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "backlinko.com",
    "limit": 5,
    "order_by": [
      "rank,desc"
    ],
    "exclude_internal_backlinks": true,
    "backlinks_filters": [
      "dofollow",
      "=",
      true
    ],
    "filters": [
      "backlinks",
      ">",
      100
    ]
  }
]'

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

{
  "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,
              "domain": 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

ریفرنگ ڈومینز

قیمت کا حوالہ