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

ڈومین انٹرسیکشن

وہ ڈومینز جو ایک ساتھ کئی اہداف سے لنک کرتے ہیں۔ ⚠️ یہاں targets ایک پوزیشن کے حساب سے کی گئی آبجیکٹ ہے - {"1": "a.com", "2": "b.com"} - نہ کہ وہ صف جو بلک endpoints لیتے ہیں۔ exclude_targets موازنے سے سائٹس نکال دیتا ہے۔ ہر قطار domain_intersection اور فی ہدف ایک summary رکھتی ہے۔ اسے یہ جاننے کے لیے استعمال کریں کہ آپ کے حریفوں سے کون لنک کرتا ہے مگر آپ سے نہیں۔ صفحہ سطح کا متبادل post_dataforseo_backlinks_page_intersection_live ہے۔

قیمت کا حوالہ

میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
حوالہ جاتی درخواست کا تخمینہ: USD 0.06۔
حوالہ جاتی صارف ملٹی پلائر: 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
 
 متعین کریں کہ کون سے بیک لنکس واپس اور شمار کیے جائیں
 اختیاری فیلڈ
 آپ یہ فیلڈ منتخب کرنے کے لیے استعمال کر سکتے ہیں کہ آپ کے targets کے مجموعی میٹرکس کے لیے کون سے بیک لنکس واپس اور استعمال کیے جائیں؛
 ممکنہ اقدار:
 all - تمام بیک لنکس واپس اور شمار کیے جائیں گے؛
 live - آخری جانچ کے دوران ملنے والے بیک لنکس واپس اور شمار کیے جائیں گے؛
 lost - گمشدہ بیک لنکس واپس اور شمار کیے جائیں گے؛
 
 ڈیفالٹ قدر: live
- exclude_internal_backlinks
 قسم: boolean | null
 
 بتاتا ہے کہ target کے ذیلی ڈومینز سے آنے والے بیک لنکس خارج ہوں گے یا نہیں
 اختیاری فیلڈ
 اگر false پر سیٹ ہو تو target کے ذیلی ڈومینز سے آنے والے بیک لنکس چھوڑ دیے جائیں گے اور آپ کو جواب میں وہی ڈومین موصول نہیں ہوگا؛
 ڈیفالٹ قدر: true
- exclude_targets
 قسم: array string[] | null
 
 وہ ڈومینز، ذیلی ڈومینز یا ویب صفحات جنہیں آپ خارج کرنا چاہتے ہیں
 اختیاری فیلڈ
 آپ زیادہ سے زیادہ 10 ڈومینز، ذیلی ڈومینز یا ویب صفحات متعین کر سکتے ہیں
 اگر آپ یہ صف استعمال کریں تو نتائج میں وہ referring domains ہوں گے جو targets سے لنک کرتے ہیں مگر exclude_targets سے لنک نہیں کرتے
 مثال:
 "exclude_targets": [ "bbc.com", "https://www.apple.com/iphone/*", "https://dataforseo.com/apis/*"]
- 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 کے ساتھ % آپریٹر استعمال کر سکتے ہیں
 مثال:
 ["1.internal_links_count",">","1"]
 
 [["2.referring_pages",">","2"], "and", ["1.backlinks",">","10"]]
 
 [["1.first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["2.target","like","%dataforseo.com%"],"or",["1.referring_domains",">","10"]]]
 
 ممکنہ فلٹرز کی مکمل فہرست یہاں دستیاب ہے۔
 
 خالی آبجیکٹ
- include_indirect_links
 قسم: boolean | null
 
 بتاتا ہے کہ targets کے بالواسطہ لنکس نتائج میں شامل ہوں گے یا نہیں
 اختیاری فیلڈ
 اگر true پر سیٹ ہو تو نتائج میں ان بالواسطہ لنکس کا ڈیٹا شامل ہوگا جو ایسے صفحے کی طرف اشارہ کرتے ہیں جو یا تو کسی ہدف کی طرف ری ڈائریکٹ ہوتا ہے، یا کینونیکل صفحے کی طرف اشارہ کرتا ہے
 اگر 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
- intersection_mode
 قسم: string | null
 
 بتاتا ہے کہ بیک لنکس کو انٹرسیکٹ کیا جائے یا نہیں
 اختیاری فیلڈ
 متعین کردہ ڈومینز کے نتائج کو انٹرسیکٹ یا ضم کرنے کے لیے یہ فیلڈ استعمال کریں
 ممکنہ اقدار: all، partial
 all - نتائج تمام بیک لنکس پر مبنی ہیں؛
 partial - نتائج صرف انٹرسیکٹ کرنے والے بیک لنکس پر مبنی ہیں؛
 ڈیفالٹ قدر: all
- 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 قدر دیکھیں گے
- targets
 قسم: object | null
 
 وہ ڈومینز، ذیلی ڈومینز یا ویب صفحات جن کے لیے لنکس حاصل کیے جائیں
 درکار فیلڈ
 آپ زیادہ سے زیادہ 20 ڈومینز، ذیلی ڈومینز یا ویب صفحات مقرر کر سکتے ہیں
 ڈومین یا ذیلی ڈومین https:// اور www. کے بغیر متعین کرنا چاہیے
 صفحہ مطلق URL کے ساتھ متعین کرنا چاہیے (بشمول http:// یا https://)
 مثال:
 "targets": { "1": "http://planet.postgresql.org/", "2": "http://gborg.postgresql.org/" }
 
 propertyName
 قسم: string | null

جوابات

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

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

status_code
قسم: integer | null

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

status_message
قسم: string | null

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

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

ٹاسکس کی صف

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

POST صف کے تمام targets سے لنک کرنے والا ڈومین شامل ہے

domain_intersection
قسم: object | null

POST صف میں متعین متعلقہ اہداف سے لنک کرنے والے ڈومینز کا ڈیٹا شامل ہے
ڈیٹا targets آبجیکٹ میں متعین ڈومینز، ذیلی ڈومینز یا صفحات سے مطابقت رکھنے والے الگ آبجیکٹس میں فراہم کیا جاتا ہے

propertyName
قسم: object | null · Response36Afe1097B20_BacklinksDomainIntersection
backlinks
قسم: integer | null فارمیٹ: int64

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

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

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

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

ٹوٹے ہوئے بیک لنکس کی تعداد

broken_pages
قسم: integer | null

ٹوٹے ہوئے صفحات کی تعداد

first_seen
قسم: string | null

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

lost_date
قسم: string | null

وہ تاریخ و وقت جب اس target سے آخری بیک لنک ختم ہوا
وہ تاریخ و وقت ظاہر کرتا ہے جب ہمارے کرالر نے صفحہ دیکھا اور اس نے 4xx یا 5xx اسٹیٹس کوڈ واپس کیا یا آخری بیک لنک ہٹا دیا گیا
UTC فارمیٹ میں: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:
2019-11-15 12:57:46 +00:00

rank
قسم: integer | null

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

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

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

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

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

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

ریفرنگ IP پتوں کی تعداد

referring_links_attributes
قسم: object | null

ریفرنگ لنکس کی لنک صفات
ریفرنگ لنکس کی لنک صفات اور ہر صفت کے حساب سے لنک کی تعداد ظاہر کرتا ہے

propertyName
قسم: integer | null

Integer numbers.

referring_links_countries
قسم: object | null

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

referring_links_platform_types
قسم: object | null

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

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

propertyName
قسم: integer | null

Integer numbers.

referring_links_semantic_locations
قسم: object | null

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

propertyName
قسم: integer | null

Integer numbers.

referring_links_tld
قسم: object | null

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

propertyName
قسم: integer | null

Integer numbers.

referring_links_types
قسم: object | null

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

propertyName
قسم: integer | null

Integer numbers.

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

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

target
قسم: string | null

وہ ڈومین جو POST صف کے متعلقہ ہدف سے لنک کرتا ہے

type
قسم: string | null

عنصر کی قسم

summary
قسم: object | null · Response36Afe1097B20_IntersectionSummaryInfo

ڈومین اشتراک کا خلاصہ شامل ہے

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

انٹرسیکشنز کی کل تعداد

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

items صف میں واپس کیے گئے نتائج کی تعداد

targets
قسم: object | null

POST صف میں ہدف ڈومینز، ذیلی ڈومینز یا ویب صفحات

propertyName
قسم: string | 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/backlinks/domain_intersection/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_intersection/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": {
      "1": "moz.com",
      "2": "ahrefs.com"
    },
    "include_subdomains": false,
    "exclude_targets": [
      "semrush.com"
    ],
    "limit": 5,
    "order_by": [
      "1.backlinks,desc"
    ],
    "exclude_internal_backlinks": true
  }
]'

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

{
  "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": [
        {
          "targets": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "domain_intersection": null,
              "summary": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

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

ڈومین انٹرسیکشن

توثیقRequired

DataForSEO

ڈومین انٹرسیکشن

قیمت کا حوالہ