DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
تاریخچه بک‌لینک‌ها
نمایه بک‌لینک یک target همان‌گونه که در هر تاریخ از یک بازه بود، با date_from، date_to و یک مورد برای هر نقطه. برای نمایه فعلی فقط از post_dataforseo_backlinks_summary_live استفاده کنید. برای سری زمانی سبک‌تر، post_dataforseo_backlinks_timeseries_summary_live معیارهای کمتری برای هر نقطه گزارش می‌کند. این نقطه پارامتر محدودیت ندارد، بنابراین تنها اهرم، فراخوانی کم‌تر آن است.
مرجع قیمت‌گذاری
- اندازه‌گیری: هزینه گزارش‌شده پاسخ.
- برآورد درخواست مرجع: 0.0271 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: array (object | null)[]
- dateنوع: string | null
_from تاریخ شروع بازه زمانی
فیلد اختیاری
حداقل مقدار2019-01-01
اگر این فیلد را مشخص نکنید، به‌طور پیش‌فرض از حداقل مقدار استفاده می‌شود
قالب تاریخ:"yyyy-mm-dd"
مثال:"2019-01-15" - dateنوع: string | null
_to تاریخ پایان بازه زمانی
فیلد اختیاری
اگر این فیلد را تعیین نکنید، به‌طور پیش‌فرض از تاریخ امروز استفاده می‌شود
قالب تاریخ:"yyyy-mm-dd"
مثال:"2019-01-15" - 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اطلاعات بیشتر درباره نحوه کار این پارامتر و نحوه محاسبه معیارهای رتبه‌بندی در این مقاله مرکز راهنمایی موجود است
- tagنوع: string | null
شناسه وظیفه تعریف‌شده توسط کاربر
فیلد اختیاری
محدودیت کاراکتر 255 است
می‌توانید از این پارامتر برای شناسایی وظیفه و تطبیق آن با نتیجه استفاده کنید
مقدارtagمشخص‌شده را در شیءdataپاسخ پیدا می‌کنید - targetنوع: string
دامنه
فیلد الزامی
دامنه باید بدونhttps://وwww.مشخص شود
- نوع: object | null · Response36Afe1097B20_BacklinksHistoryLiveResponseInfo200
- نوع: number | null قالب: doublecost
هزینه کل وظایف، دلار آمریکا
- نوع: integer | nullstatus
_code کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید
- نوع: string | nullstatus
_message پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید
- نوع: array (object | null)[] | nulltasks
آرایه‌ای از وظایف
- نوع: object | null · Response36Afe1097B20_BacklinksHistoryLiveTaskInfo
- 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
آرایه‌ای از نتایج
- dateنوع: string | null
_from تاریخ شروع بازه زمانی
در قالب UTC: “yyyy-mm-dd”
مثال:2019-01-01 - dateنوع: string | null
_to تاریخ پایان بازه زمانی
در قالب UTC:"yyyy-mm-dd"
مثال:"2019-01-15" - itemsنوع: array (object | null)[] | null
داده‌های تاریخی بک‌لینک را برای دامنه مشخص‌شده در بر دارد
داده‌ها ماه‌به‌ماه ارائه می‌شوند؛
معیارها بر اساس بک‌لینک‌هایی که دامنه مشخص‌شده در روز اول هر ماه داده‌شده داشت، تجمیع می‌شوند- backlinksنوع: integer | null قالب: int64
تعداد بک‌لینک‌ها
- brokenنوع: integer | null قالب: int64
_backlinks تعداد بک‌لینک‌های شکسته
تعداد بک‌لینک‌های شکسته‌ای که بهtargetاشاره می‌کنند - brokenنوع: integer | null
_pages تعداد صفحات شکسته
تعداد صفحه‌هایی که بک‌لینک دریافت می‌کنند اما با کدهای وضعیت 4xx یا 5xx پاسخ می‌دهند - crawledنوع: integer | null
_pages تعداد صفحات خزش‌شده برای
target - dateنوع: string | null
تاریخ و زمانی که داده‌های هدف ذخیره شد
در قالب UTC: "yyyy-mm-dd hh-mm-ss +00:00"
مثال:2019-11-15 12:57:46 +00:00 - externalنوع: integer | null قالب: int64
_links _count تعداد پیوندهای خارجی در صفحه
به‌صورت مجموع پیوندهای خارجی در صفحه‌هایtargetمشخص‌شده محاسبه می‌شود - infoنوع: object | null · Response36Afe1097B20_TargetInfo
اطلاعات درباره
target- cmsنوع: string | null
سیستم مدیریت محتوا
- countryنوع: string | null
کد کشوری که دامنه
targetمتعلق به آن تعیین شده است - ipنوع: string | null
_address نشانی IP
target - isنوع: boolean | null
_ip نشان می‌دهد آیا
targetیک IP است
اگرtrueباشد، دامنه، زیردامنه یا صفحه وب به‌عنوان نشانی IP عمل می‌کند و نام دامنه ندارد - platformنوع: array (string | null)[] | null
_type نوع پلتفرم
- serverنوع: string | null
سرور
- targetنوع: integer | null
_spam _score
- internalنوع: integer | null قالب: int64
_links _count تعداد پیوندهای داخلی
به‌صورت مجموع پیوندهای داخلی در صفحه‌هایtargetمشخص‌شده محاسبه می‌شود - lostنوع: integer | null قالب: int64
_backlinks تعداد بک‌لینک‌های ازدست‌رفته برای
target
داده‌ها بر اساس مقایسه با دوره قبل ارائه می‌شوند
نکته: این داده‌ها از مه 2021 در دسترس‌اند؛
اگر بازه تاریخ مشخص‌شده در درخواست POST پیش از مه 2021 باشد، این فیلد برابر0خواهد بود - lostنوع: integer | null قالب: int64
_referring _domains تعداد دامنه‌های ارجاع‌دهنده ازدست‌رفته برای
target
داده‌ها بر اساس مقایسه با دوره قبل ارائه می‌شوند
نکته: این داده‌ها از مه 2021 در دسترس‌اند؛
اگر بازه تاریخ مشخص‌شده در درخواست POST پیش از مه 2021 باشد، این فیلد برابر0خواهد بود - newنوع: integer | null قالب: int64
_backlinks تعداد بک‌لینک‌های جدید برای
target
داده‌ها بر اساس مقایسه با دوره قبل ارائه می‌شوند
نکته: این داده‌ها از مه 2021 در دسترس‌اند؛
اگر بازه تاریخ مشخص‌شده در درخواست POST پیش از مه 2021 باشد، این فیلد برابر0خواهد بود - newنوع: integer | null قالب: int64
_referring _domains تعداد دامنه‌های ارجاع‌دهنده جدید برای
target
داده‌ها بر اساس مقایسه با دوره قبل ارائه می‌شوند
نکته: این داده‌ها از مه 2021 در دسترس‌اند؛
اگر بازه تاریخ مشخص‌شده در درخواست POST پیش از مه 2021 باشد، این فیلد برابر0خواهد بود - rankنوع: integer | null
- referringنوع: integer | null قالب: int64
_domains تعداد دامنه‌های ارجاع‌دهنده
دامنه‌های ارجاع‌دهنده شامل زیردامنه‌هایی می‌شوند که برای این معیار دامنه‌های جداگانه شمرده می‌شوند - referringنوع: integer | null قالب: int64
_domains _nofollow تعداد دامنه‌هایی که دست‌کم یک پیوند nofollow به
targetاشاره می‌کنند - referringنوع: integer | null قالب: int64
_ips تعداد نشانی‌های IP ارجاع‌دهنده
تعداد نشانی‌های IP که به این صفحه اشاره می‌کنند - referringنوع: object | null
_links _attributes ویژگی‌های پیوندِ پیوندهای ارجاع‌دهنده
ویژگی‌های پیوندِ پیوندهای ارجاع‌دهنده و تعداد پیوند برای هر ویژگی را نشان می‌دهد- propertyنوع: integer | null قالب: int64
Name Signed 64-bit integers (long type).
- referringنوع: object | null
_links _countries کدهای کشور ISO پیوندهای ارجاع‌دهنده
کدهای کشور ISO دامنه‌هایی را نشان می‌دهد که پیوندهای ارجاع‌دهنده در آن‌ها قرار دارند و تعداد پیوند برای هر کشور- propertyنوع: integer | null قالب: int64
Name Signed 64-bit integers (long type).
- referringنوع: object | null
_links _platform _types انواع پلتفرم‌های ارجاع‌دهنده
انواع پلتفرم‌های ارجاع‌دهنده و تعداد پیوند برای هر پلتفرم را نشان میدهدمقادیر ممکن:
cms،blogs،ecommerce،message-boards،wikis،news،organization- propertyنوع: integer | null قالب: int64
Name Signed 64-bit integers (long type).
- referringنوع: object | null
_links _semantic _locations - propertyنوع: integer | null قالب: int64
Name Signed 64-bit integers (long type).
- referringنوع: object | null
_links _tld دامنه‌های سطح بالای پیوندهای ارجاع‌دهنده
شامل دامنه‌های سطح بالا و تعداد پیوندهای ارجاع‌دهنده برای هر یک است- propertyنوع: integer | null قالب: int64
Name Signed 64-bit integers (long type).
- referringنوع: object | null
_links _types انواع پیوندهای ارجاع‌دهنده
انواع پیوندهای ارجاع‌دهنده و تعداد پیوند برای هر نوع را نشان می‌دهد
مقادیر ممکن:anchor،image،link،meta،canonical،alternate،redirect- propertyنوع: integer | null قالب: int64
Name Signed 64-bit integers (long type).
- referringنوع: integer | null قالب: int64
_main _domains تعداد دامنه‌های اصلی ارجاع‌دهنده
- referringنوع: integer | null قالب: int64
_main _domains _nofollow تعداد دامنه‌های اصلی که دست‌کم یک پیوند nofollow به
targetاشاره می‌کنند - referringنوع: integer | null قالب: int64
_pages تعداد صفحه‌هایی که به
targetاشاره می‌کنند - referringنوع: integer | null قالب: int64
_pages _nofollow تعداد صفحه‌های ارجاع‌دهنده‌ای که دست‌کم یک پیوند nofollow به
targetاشاره می‌کنند - referringنوع: integer | null قالب: int64
_subnets تعداد زیرشبکه‌های ارجاع‌دهنده
- typeنوع: string | null
نوع عنصر
- itemsنوع: integer | null قالب: int64
_count تعداد نتایج بازگردانده‌شده در آرایه
items - targetنوع: string | null
targetاز آرایه POST
- 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/history/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "cnn.com",
"date_from": "2020-01-01",
"date_to": "2021-01-01"
}
]'
{
"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,
"date_from": null,
"date_to": null,
"items_count": null,
"items": [
{
"type": null,
"date": null,
"rank": null,
"backlinks": null,
"new_backlinks": null,
"lost_backlinks": null,
"new_referring_domains": null,
"lost_referring_domains": null,
"crawled_pages": null,
"info": "[Max Depth Exceeded]",
"internal_links_count": null,
"external_links_count": 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
}
]
}
]
}
]
}