DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
بک‌لینک‌ها
لینک‌های ورودی منفرد به یک target، یک ردیف برای هر لینک. total_count، items_count، items و یک search_after_token برای صفحه‌بندی برمی‌گرداند — پس از چند صفحه اول از آن به‌جای offset استفاده کنید. mode و custom_mode گروه‌بندی را کنترل می‌کنند و backlinks_status_type حالت زنده، ازدست‌رفته یا همه را انتخاب می‌کند. برای شمارش به‌جای ردیف از post_dataforseo_backlinks_summary_live استفاده کنید؛ و برای دامنه‌های پیونددهنده گروه‌بندی‌شده، post_dataforseo_backlinks_referring_domains_live.
مرجع قیمت‌گذاری
- اندازه‌گیری: هزینه گزارش‌شده پاسخ.
- برآورد درخواست مرجع: 0.06 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: array (object | null)[]
- backlinksنوع: string | null
_status _type تعیین بک‌لینک‌هایی که برگردانده و شمارش می‌شوند
فیلد اختیاری
می‌توانید از این فیلد برای انتخاب بک‌لینک‌هایی استفاده کنید که برگردانده می‌شوند و در معیارهای تجمیعیtargetبه کار می‌روند؛
مقادیر ممکن:all— همه بک‌لینک‌ها برگردانده و شمارش می‌شوند؛live— بک‌لینک‌های یافت‌شده در آخرین بررسی برگردانده و شمارش می‌شوند؛lost— بک‌لینک‌های ازدست‌رفته برگردانده و شمارش می‌شوند؛مقدار پیش‌فرض:
live - customنوع: object | null
_mode نوع گروه‌بندی نتایج تفصیلی
فیلد اختیاری
از این شیء برای دریافت تعداد مشخصی بک‌لینک در هرfieldاستفاده کنید
اگر ازcustom_modeاستفاده کنید،modeنادیده گرفته می‌شود
مثال:"custom_mode": {"field": "domain", "value": 100}- propertyنوع: object | null
Name
- excludeنوع: boolean | null
_internal _backlinks نشان می‌دهد آیا بک‌لینک‌های داخلی از زیردامنه‌ها به
targetاز نتایج مستثنی می‌شوند
فیلد اختیاری
اگر رویtrueتنظیم شود، نتایج داده‌های مربوط به بک‌لینک‌های داخلی از زیردامنه‌های همان دامنهtargetرا شامل نمی‌شوند
اگر رویfalseتنظیم شود، پیوندهای داخلی در نتایج گنجانده می‌شوند
مقدار پیش‌فرض:true - filtersنوع: array (object | null)[] | null
آرایه پارامترهای فیلتر نتایج
فیلد اختیاری
می‌توانید چند فیلتر را هم‌زمان اضافه کنید (حداکثر 8 فیلتر)
باید بین شرایط یک عملگر منطقیandیاorبگذارید
عملگرهای پشتیبانی‌شده:=،<>،in،not_in،like،not_like،ilike،not_ilike،regex،not_regex،match،not_match
می‌توانید عملگر%را باlikeوnot_likeبرای تطبیق هر رشته صفر یا بیشتر نویسه به کار ببرید
مثال:["rank",">","80"][["page_from_rank",">","55"],
"and",
["dofollow","=",true]][["first_seen",">","2017-10-23 11:31:45 +00:00"],
"and",
[["anchor","like","%seo%"],"or",["text_pre","like","%seo%"]]]شیء خالی - includeنوع: boolean | null
_subdomains نشان می‌دهد آیا زیردامنه‌های
targetدر جستجو گنجانده می‌شوند
فیلد اختیاری
اگر رویfalseتنظیم شود، زیردامنه‌ها نادیده گرفته می‌شوند
مقدار پیش‌فرض:true - limitنوع: integer | null
حداکثر تعداد بک‌لینک‌های برگردانده‌شده
فیلد اختیاریمقدار پیش‌فرض:
100
حداکثر مقدار:1000 - modeنوع: string | null
نوع گروه‌بندی نتایج
فیلد اختیاری
انواع گروه‌بندی ممکن:as_is— همه بک‌لینک‌ها را برمی‌گرداندone_per_domain— یک بک‌لینک برای هر دامنه برمی‌گرداندone_per_anchor— یک بک‌لینک برای هر لنگر برمیگرداندمقدار پیش‌فرض:
as_is - offsetنوع: integer | null
آفست در آرایه نتایج بک‌لینک‌های برگردانده‌شده
فیلد اختیاریمقدار پیش‌فرض:
0
اگر مقدار10را مشخص کنید، ده بک‌لینک اول در آرایه نتایج حذف می‌شود و داده‌ها برای بک‌لینک‌های بعدی ارائه می‌شوند؛
نکته: حداکثر مقدار20,000است؛ اگر می‌خواهید نتایج بیشتری را آفست کنید، ازsearch_after_tokenاستفاده کنید - orderنوع: array string[] | null
_by قواعد مرتب‌سازی نتایج
فیلد اختیاری
می‌توانید از همان مقادیر آرایهfiltersبرای مرتب‌سازی نتایج استفاده کنید
انواع مرتب‌سازی ممکن:asc— نتایج به ترتیب صعودی مرتب می‌شوندdesc— نتایج به ترتیب نزولی مرتب می‌شوند
برای تعیین نوع مرتب‌سازی از ویرگول استفاده کنید
مثال:["rank,desc"]
توجه کنید که در یک درخواست نمی‌توان بیش از سه قاعده مرتب‌سازی تعیین کرد
باید چند قاعده مرتب‌سازی را با ویرگول جدا کنید
مثال:["domain_from_rank,desc","page_from_rank,asc"] - rankنوع: string | null
_scale مقیاسی را تعیین می‌کند که مقادیر
rank،domain_from_rankوpage_from_rankبر اساس آن محاسبه و نمایش داده می‌شوند
فیلد اختیاریمیتوانید از این پارامتر برای انتخاب اینکه مقادیر رتبه در مقیاس 0–100 یا 0–1000 نمایش داده شوند استفاده کنید
مقادیر ممکن:
one_hundred— مقادیر رتبه در مقیاس 0–100 نمایش داده می‌شوندone_thousand— مقادیر رتبه در مقیاس 0–1000 نمایش داده میشوندمقدار پیش‌فرض:
one_thousandاطلاعات بیشتر درباره نحوه کار این پارامتر و نحوه محاسبه معیارهای رتبه‌بندی در این مقاله مرکز راهنمایی موجود است
- searchنوع: string | null
_after _token توکن برای درخواست‌های بعدی
فیلد اختیاری
در فیلد یکسان پاسخ هر درخواست ارائه می‌شود؛
از این پارامتر برای جلوگیری از وقفه زمانی هنگام تلاش برای دریافت بیش از20,000نتیجه در یک درخواست استفاده کنید؛
با مشخص کردن مقدار یکتایsearch_after_tokenاز آرایه پاسخ، نتایج بعدی وظیفه اولیه را دریافت می‌کنید؛
مقادیرsearch_after_tokenبرای هر وظیفه بعدی یکتا هستند؛
نکته: اگرsearch_after_tokenدر درخواست مشخص شود، همه پارامترهای دیگر باید با درخواست قبلی یکسان باشند - tagنوع: string | null
شناسه وظیفه تعریف‌شده توسط کاربر
فیلد اختیاری
محدودیت کاراکتر 255 است
می‌توانید از این پارامتر برای شناسایی وظیفه و تطبیق آن با نتیجه استفاده کنید
مقدارtagمشخص‌شده را در شیءdataپاسخ پیدا می‌کنید - targetنوع: string
دامنه، زیردامنه یا صفحه‌ای که بک‌لینک‌ها برای آن دریافت می‌شوند
فیلد الزامی
دامنه یا زیردامنه باید بدونhttps://وwww.مشخص شود
صفحه باید با URL مطلق (شاملhttp://یاhttps://) مشخص شود
- نوع: object | null · Response36Afe1097B20_BacklinksBacklinksLiveResponseInfo200
- نوع: number | null قالب: doublecost
هزینه کل وظایف، دلار آمریکا
- نوع: integer | nullstatus
_code کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید
- نوع: string | nullstatus
_message پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید
- نوع: array (object | null)[] | nulltasks
آرایه‌ای از وظایف
- نوع: object | null · Response36Afe1097B20_BacklinksBacklinksLiveTaskInfo
- costنوع: number | null قالب: double
هزینه کل وظایف، دلار آمریکا
- dataنوع: object | null
همان پارامترهایی را دارد که در درخواست POST تعیین کرده‌اید
- propertyنوع: object | null
Name
- idنوع: string | null
شناسه وظیفه شناسه یکتای وظیفه در سیستم ما در قالب UUID
- pathنوع: array (string | null)[] | null
مسیر URL
- resultنوع: array (object | null)[] | null
آرایه‌ای از نتایج
- customنوع: object | null
_mode حالت سفارشی مشخص‌شده در آرایه POST
- propertyنوع: object | null
Name
- itemsنوع: array (object | null)[] | null
داده‌های مرتبط بک‌لینک و دامنه‌های ارجاع‌دهنده را در بر دارد
- altنوع: string | null
متن جایگزین تصویر
اگرtypeبک‌لینک image نباشد، این فیلدnullخواهد بود - anchorنوع: string | null
متن لنگر بک‌لینک
- attributesنوع: array (string | null)[] | null
ویژگی‌های پیوندِ پیوندهای ارجاع‌دهنده
مثال:nofollow - backlinkنوع: integer | null
_spam _score - dofollowنوع: boolean | null
نشان می‌دهد آیا بک‌لینک dofollow است
اگرfalseباشد، بک‌لینک nofollow است - domainنوع: string | null
_from دامنه‌ای که به دامنه هدف یا صفحه وب ارجاع می‌دهد
- domainنوع: string | null
_from _country کد کشور ISO دامنه ارجاع‌دهنده
- domainنوع: string | null
_from _ip نشانی IP دامنه ارجاع‌دهنده
- domainنوع: boolean | null
_from _is _ip نشان می‌دهد آیا دامنه IP است
اگرtrueباشد، دامنه به‌عنوان نشانی IP عمل می‌کند و نام دامنه ندارد - domainنوع: array (string | null)[] | null
_from _platform _type انواع پلتفرم دامنه ارجاع‌دهنده
مقادیر ممکن:
cms،blogs،ecommerce،message-boards،wikis،news،organization - domainنوع: integer | null
_from _rank - domainنوع: string | null
_to دامنه‌ای که بک‌لینک به آن اشاره می‌کند
- firstنوع: string | null
_seen تاریخ و زمانی که خزنده ما بک‌لینک را نخستین بار پیدا کرد
در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - groupنوع: integer | null قالب: int64
_count کل بک‌لینک‌های این دامنه را نشان می‌دهد
برای مثال، اگرmodeرویone_per_domainتنظیم شده باشد، این فیلد کل بک‌لینک‌های برگرفته از این دامنه را نشان می‌دهد - imageنوع: string | null
_url نشانی URL تصویر
نشانی URL منتهی به تصویر در منبع اصلی یا فضای ذخیره‌سازی DataForSEO (اگر منبع اصلی در دسترس نباشد) - indirectنوع: array (object | null)[] | null
_link _path مسیر پیوند غیرمستقیم
نشانی URL یا دنباله‌ای از نشانی‌های URL را نشان می‌دهد که بهurl_toمی‌رسند- statusنوع: integer | null
_code کد وضعیت عمومی
فهرست کامل کدهای پاسخ را می‌توانید اینجا بیابید
نکته: اکیداً توصیه می‌کنیم سامانه‌ای لازم برای مدیریت شرایط استثنایی یا خطاهای مرتبط طراحی کنید - typeنوع: string | null
نوع عنصر
- urlنوع: string | null
نشانی URL پیوند غیرمستقیم
- isنوع: boolean | null
_broken نشان می‌دهد آیا بک‌لینک شکسته است
اگرtrueباشد، بک‌لینک به صفحه‌ای اشاره می‌کند که با کد وضعیت 4xx یا 5xx پاسخ می‌دهد - isنوع: boolean | null
_indirect _link نشان می‌دهد آیا بک‌لینک پیوند غیرمستقیم است
اگرtrueباشد، بک‌لینک پیوند غیرمستقیمی است که به صفحه‌ای اشاره می‌کند که یا بهurl_toتغییرمسیر می‌دهد یا به یک صفحه کانونیکال اشاره می‌کند - isنوع: boolean | null
_lost نشان می‌دهد آیا بک‌لینک حذف شده است
اگرtrueباشد، بک‌لینک یا کل صفحه حذف شده است - isنوع: boolean | null
_new نشان می‌دهد آیا بک‌لینک جدید است
اگرtrueباشد، بک‌لینک در آخرین بازدید خزنده ما از صفحه پیدا شده است - itemنوع: string | null
_type نوع پیوند
مقادیر ممکن:anchor،image،meta،canonical،alternate،redirect - lastنوع: string | null
_seen جدیدترین تاریخی که خزنده ما از بک‌لینک بازدید کرد
در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - linksنوع: integer | null قالب: int64
_count تعداد بک‌لینک‌های یکسانی که در صفحه ارجاع‌دهنده پیدا شد
- originalنوع: boolean | null
نشان می‌دهد آیا بک‌لینک هنگام نخستین بازدید خزنده ما از صفحه ارجاع‌دهنده در آن وجود داشت
- pageنوع: string | null
_from _encoding کدگذاری نویسه‌های صفحه ارجاع‌دهنده
مثال:utf-8 - pageنوع: integer | null
_from _external _links تعداد پیوندهای خارجی پیدا‌شده در صفحه ارجاع‌دهنده
- pageنوع: integer | null
_from _internal _links تعداد پیوندهای داخلی پیدا‌شده در صفحه ارجاع‌دهنده
- pageنوع: string | null
_from _language زبان صفحه ارجاع‌دهنده
در قالب ISO 639-1
مثال:en - pageنوع: integer | null
_from _rank - pageنوع: integer | null
_from _size اندازه صفحه ارجاع‌دهنده بر حسب بایت
مثال:63357 - pageنوع: integer | null
_from _status _code کد وضعیت HTTP بازگردانده‌شده توسط صفحه ارجاع‌دهنده
مثال:200 - pageنوع: string | null
_from _title عنوان صفحه ارجاع‌دهنده
- prevنوع: string | null
_seen تاریخ پیش از جدیدترین تاریخی که خزنده ما از بک‌لینک بازدید کرد
در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - rankنوع: integer | null
- rankedنوع: object | null · Response36Afe1097B20_RankedKeywordsInfo
_keywords _info - pageنوع: integer | null قالب: int64
_from _keywords _count _top _10 Signed 64-bit integers (long type).
- pageنوع: integer | null قالب: int64
_from _keywords _count _top _100 Signed 64-bit integers (long type).
- pageنوع: integer | null قالب: int64
_from _keywords _count _top _3 Signed 64-bit integers (long type).
- semanticنوع: string | null
_location - textنوع: string | null
_post قطعه پس از متن لنگر
- textنوع: string | null
_pre قطعه پیش از متن لنگر
- tldنوع: string | null
_from دامنه سطح بالای نشانی URL ارجاع‌دهنده
- typeنوع: string | null
نوع عنصر
- urlنوع: string | null
_from نشانی URL صفحه‌ای که بک‌لینک در آن پیدا شده است
- urlنوع: boolean | null
_from _https نشان می‌دهد آیا نشانی URL ارجاع‌دهنده با HTTPS ایمن شده است
اگرtrueباشد، نشانی URL ارجاع‌دهنده با HTTPS ایمن شده است - urlنوع: string | null
_to نشانی URLی که بک‌لینک به آن اشاره می‌کند
- urlنوع: boolean | null
_to _https نشان می‌دهد آیا نشانی URLی که بک‌لینک به آن اشاره می‌کند با HTTPS ایمن شده است
اگرtrueباشد، نشانی URL با HTTPS ایمن شده است - urlنوع: string | null
_to _redirect _target نشانی URL هدف تغییرمسیر
صفحه هدفی که تغییرمسیر به آن اشاره می‌کند - urlنوع: integer | null
_to _spam _score - urlنوع: integer | null
_to _status _code کد وضعیت صفحه‌ای که پیوند به آن اشاره دارد
اگر مقدارnullباشد، خزنده ما هنوز از صفحه‌ای که پیوند به آن اشاره دارد بازدید نکرده است
مثال:200
- itemsنوع: integer | null قالب: int64
_count تعداد نتایج بازگردانده‌شده در آرایه
items - modeنوع: string | null
حالت مشخص‌شده در آرایه POST
- searchنوع: string | null
_after _token توکن برای درخواست‌های بعدی
با مشخص کردنsearch_after_tokenیکتا هنگام تعریف وظیفه جدید، نتایج بعدی وظیفه اولیه را دریافت می‌کنید؛
مقادیرsearch_after_tokenبرای هر وظیفه بعدی یکتاست - targetنوع: string | null
دامنه هدف در آرایه POST
- totalنوع: integer | null قالب: int64
_count کل نتایج مرتبط با درخواست
- resultنوع: integer | null قالب: int64
_count تعداد عناصر در آرایه result
- statusنوع: integer | null
_code کد وضعیت وظیفه توسط DataForSEO تولید می‌شود و می‌تواند در بازه زیر باشد: 10000-60000 فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید
- statusنوع: string | null
_message پیام اطلاعاتی وظیفه فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید
- timeنوع: string | null
زمان اجرا، ثانیه
- نوع: integer | null قالب: int64tasks
_count تعداد وظایف در آرایه tasks
- نوع: integer | null قالب: int64tasks
_error تعداد وظایف در آرایه tasks که با خطا برگردانده شده‌اند
- نوع: string | nulltime
زمان کل اجرا، بر حسب ثانیه
- نوع: string | nullversion
نسخه فعلی API
application/json - 400
درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.
- 401
یک کلید API معتبر Felo لازم است.
- 402
درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.
- 403
حساب مجاز به انجام این عملیات نیست.
- 429
به سقف درخواست یا هزینه رسیده‌اید.
- 502
سرویس نتوانست درخواست را کامل کند.
- 503
سرویس API یا صورت‌حساب موقتاً در دسترس نیست.
- 504
سرویس هنگام پردازش درخواست به پایان مهلت رسید.
- default
پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/backlinks/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "forbes.com",
"mode": "as_is",
"filters": [
"dofollow",
"=",
true
],
"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": [
{
"target": null,
"mode": null,
"custom_mode": null,
"total_count": null,
"items_count": null,
"items": [
{
"type": null,
"domain_from": null,
"url_from": null,
"url_from_https": null,
"domain_to": null,
"url_to": null,
"url_to_https": null,
"tld_from": null,
"is_new": null,
"is_lost": null,
"backlink_spam_score": null,
"rank": null,
"page_from_rank": null,
"domain_from_rank": null,
"domain_from_platform_type": [
"[Max Depth Exceeded]"
],
"domain_from_is_ip": null,
"domain_from_ip": null,
"domain_from_country": null,
"page_from_external_links": null,
"page_from_internal_links": null,
"page_from_size": null,
"page_from_encoding": null,
"page_from_language": null,
"page_from_title": null,
"page_from_status_code": null,
"first_seen": null,
"prev_seen": null,
"last_seen": null,
"item_type": null,
"attributes": [
"[Max Depth Exceeded]"
],
"dofollow": null,
"original": null,
"alt": null,
"image_url": null,
"anchor": null,
"text_pre": null,
"text_post": null,
"semantic_location": null,
"links_count": null,
"group_count": null,
"is_broken": null,
"url_to_status_code": null,
"url_to_spam_score": null,
"url_to_redirect_target": null,
"ranked_keywords_info": "[Max Depth Exceeded]",
"is_indirect_link": null,
"indirect_link_path": [
"[Max Depth Exceeded]"
]
}
],
"search_after_token": null
}
]
}
]
}