DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
صفحه‌های دامنه
صفحه‌های یک target که لینک ورودی دارند، همراه با نمای خزنده از هرکدام: main_domain، domain، tld، page، ip، first_visited، prev_visited و fetch_time. از آن برای یافتن صفحه‌هایی که واقعاً لینک کسب می‌کنند استفاده کنید. برای شمار بک‌لینک هر صفحه به‌جای فراداده خزش از post_dataforseo_backlinks_domain_pages_summary_live استفاده کنید.
مرجع قیمت‌گذاری
- اندازه‌گیری: هزینه گزارش‌شده پاسخ.
- برآورد درخواست مرجع: 0.0276 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: array (object | null)[]
- backlinksنوع: array (object | null)[] | null
_filters فیلتر بک‌لینک‌های
target
فیلد اختیاری
می‌توانید از این فیلد برای فیلتر بک‌لینک‌های اولیه‌ای استفاده کنید که در مجموعه داده معیارهای تجمیعیtargetگنجانده می‌شوند
می‌توانید بک‌لینک‌ها را بر اساس همه فیلدهای موجود در پاسخ این نقطه پایانی فیلتر کنید
با استفاده از این پارامتر، می‌توانید فقط بک‌لینک‌های dofollow را در پاسخ بگنجانید و مجموعه داده انعطاف‌پذیری از بک‌لینک‌ها برای محاسبه معیارهای آن بسازید
مثال:"backlinks_filters": ["dofollow", "=", true]شیء خالی - backlinksنوع: string | null
_status _type تعیین بک‌لینک‌هایی که برگردانده و شمارش می‌شوند
فیلد اختیاری
می‌توانید از این فیلد برای انتخاب بک‌لینک‌هایی استفاده کنید که برگردانده می‌شوند و در معیارهای تجمیعی به کار می‌روند؛
مقادیر ممکن:all— همه بک‌لینک‌ها برگردانده و شمارش می‌شوند؛live— بک‌لینک‌های یافت‌شده در آخرین بررسی برگردانده و شمارش می‌شوند؛lost— بک‌لینک‌های ازدست‌رفته برگردانده و شمارش می‌شوند؛مقدار پیش‌فرض:
live - excludeنوع: boolean | null
_internal _backlinks نشان می‌دهد آیا بک‌لینک‌های داخلی از زیردامنه‌ها به
targetاز نتایج مستثنی می‌شوند
فیلد اختیاری
اگر رویtrueتنظیم شود، نتایج داده‌های مربوط به بک‌لینک‌های داخلی از زیردامنه‌های همان دامنهtargetرا شامل نمی‌شوند
اگر رویfalseتنظیم شود، پیوندهای داخلی در نتایج گنجانده می‌شوند
مقدار پیش‌فرض: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برای تطبیق هر رشته صفر یا بیشتر نویسه به کار ببرید
مثال:["meta.internal_links_count",">","1"][["meta.external_links_count",">","2"],
"and",
["backlinks",">","10"]][["first_visited",">","2017-10-23 11:31:45 +00:00"],
"and",
[["title","like","%seo%"],"or",["referring_domains",">","10"]]]شیء خالی - includeنوع: boolean | null
_subdomains نشان می‌دهد آیا زیردامنه‌های
targetدر جستجو گنجانده می‌شوند
فیلد اختیاری
اگر رویfalseتنظیم شود، زیردامنه‌ها نادیده گرفته می‌شوند
مقدار پیش‌فرض:true - internalنوع: integer | null
_list _limit حداکثر تعداد عناصر در آرایه‌های داخلی
فیلد اختیاری
می‌توانید از این فیلد برای محدود کردن تعداد عناصر در آرایه‌های زیر استفاده کنید:referring_links_tldreferring_links_typesreferring_links_attributesreferring_links_platform_typesreferring_links_semantic_locationsمقدار پیش‌فرض:
10
حداکثر مقدار:1000 - limitنوع: integer | null
حداکثر تعداد صفحات برگشتی
فیلد اختیاری
مقدار پیش‌فرض:100
حداکثر مقدار:1000 - offsetنوع: integer | null
آفست در آرایه نتایج صفحات برگشتی
فیلد اختیاری
مقدار پیش‌فرض:0
اگر مقدار10را تعیین کنید، ده صفحه نخست در آرایه نتایج حذف می‌شود و داده‌ها برای صفحات بعدی ارائه می‌شود - orderنوع: array string[] | null
_by قواعد مرتب‌سازی نتایج
فیلد اختیاری
می‌توانید از همان مقادیر آرایهfiltersبرای مرتب‌سازی نتایج استفاده کنید
انواع مرتب‌سازی ممکن:asc— نتایج به ترتیب صعودی مرتب می‌شوندdesc— نتایج به ترتیب نزولی مرتب می‌شوند
برای تعیین نوع مرتب‌سازی از ویرگول استفاده کنید
مثال:["page_summary.backlinks,desc"]
توجه کنید که در یک درخواست نمی‌توان بیش از سه قاعده مرتب‌سازی تعیین کرد
باید چند قاعده مرتب‌سازی را با ویرگول جدا کنید
مثال:["page_summary.backlinks,desc","page_summary.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اطلاعات بیشتر درباره نحوه کار این پارامتر و نحوه محاسبه معیارهای رتبه‌بندی در این مقاله مرکز راهنمایی موجود است
- tagنوع: string | null
شناسه وظیفه تعریف‌شده توسط کاربر
فیلد اختیاری
محدودیت کاراکتر 255 است
می‌توانید از این پارامتر برای شناسایی وظیفه و تطبیق آن با نتیجه استفاده کنید
مقدارtagمشخص‌شده را در شیءdataپاسخ پیدا می‌کنید - targetنوع: string
دامنه یا زیردامنه
فیلد الزامی
دامنه یا زیردامنه باید بدونhttps://وwww.مشخص شود
مثال:forbes.com
- نوع: object | null · Response36Afe1097B20_BacklinksDomainPagesLiveResponseInfo200
- نوع: number | null قالب: doublecost
هزینه کل وظایف، دلار آمریکا
- نوع: integer | nullstatus
_code کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید
- نوع: string | nullstatus
_message پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید
- نوع: array (object | null)[] | nulltasks
آرایه‌ای از وظایف
- نوع: object | null · Response36Afe1097B20_BacklinksDomainPagesLiveTaskInfo
- 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
آرایه‌ای از نتایج
- itemsنوع: array (object | null)[] | null
آرایه آیتم‌ها
- contentنوع: string | null
_encoding نوع کدگذاری
- domainنوع: string | null
دامنه
دامنه‌ای که صفحه در آن پیدا شد - encodedنوع: integer | null
_size اندازه صفحه پس از کدگذاری
اندازه صفحه کدگذاری‌شده را بر حسب بایت نشان می‌دهد - fetchنوع: string | null
_time جدیدترین تاریخ و زمانی که خزنده ما از صفحه بازدید کرد
در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2017-01-24 13:20:59 +00:00 - firstنوع: string | null
_visited تاریخ و زمان نخستین بازدید از صفحه
تاریخ و زمانی که خزنده ما نخستین بار از این صفحه بازدید کرد
در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2017-01-24 13:20:59 +00:00 - ipنوع: string | null
نشانی IP
- locationنوع: string | null
هدر Location
نشانی URLی را نشان می‌دهد که در صورت وجود، صفحه به آن تغییرمسیر داده می‌شود - mainنوع: string | null
_domain دامنه اصلی وب‌سایت
دامنه اصلی وب‌سایت شامل زیردامنه‌ها نمی‌شود - mediaنوع: string | null
_type انواع رسانه‌های استفاده‌شده برای نمایش صفحه
- metaنوع: object | null · Response36Afe1097B20_BacklinksPageMeta
فراداده صفحه
- canonicalنوع: string | null
صفحه کانونیکال
- charsetنوع: string | null
کدگذاری نویسه‌ها
مثال‌ها:utf-8 - externalنوع: integer | null قالب: int64
_links _count تعداد پیوندهای خارجی در صفحه
- h1نوع: array (string | null)[] | null
تگ h1
محتوای تگ‌هایh1 - h2نوع: array (string | null)[] | null
تگ h2
محتوای تگ‌هایh2 - h3نوع: array (string | null)[] | null
تگ h3
محتوای تگ‌هایh3 - imagesنوع: array (string | null)[] | null
_alt محتوای تگ‌های
alt - imagesنوع: integer | null قالب: int64
_count تعداد تصاویر در صفحه
- internalنوع: integer | null قالب: int64
_links _count تعداد پیوندهای داخلی در صفحه
- languageنوع: string | null
زبان محتوای صفحه
مثال:en - pageنوع: integer | null
_spam _score - platformنوع: array (string | null)[] | null
_type نوع پلتفرم
- poweredنوع: array (string | null)[] | null
_by جزئیات CMS
- socialنوع: object | null
_media _tags - propertyنوع: string | null
Name
- technologiesنوع: object | null
فناوری‌های وب‌سایت
- propertyنوع: string | null
Name
- titleنوع: string | null
عنوان صفحه
- wordsنوع: integer | null قالب: int64
_count تعداد واژه‌های صفحه
- pageنوع: string | null
نشانی URL صفحه
نشانی URL صفحه مرتبط - pageنوع: object | null · Response36Afe1097B20_PageSummary
_summary داده‌های بک‌لینک این صفحه را در بر دارد
- backlinksنوع: integer | null قالب: int64
تعداد بک‌لینک‌ها را نشان می‌دهد
- backlinksنوع: integer | null قالب: int64
_spam _score - brokenنوع: integer | null قالب: int64
_backlinks تعداد بک‌لینک‌های شکسته
تعداد بک‌لینک‌های شکسته‌ای که بهpageاشاره می‌کنند - brokenنوع: integer | null
_pages تعداد صفحات شکسته
تعداد صفحه‌هایی که با کدهای وضعیت 4xx یا 5xx پاسخ می‌دهند و بک‌لینک‌ها به آن‌ها اشاره می‌کنند - firstنوع: string | null
_seen تاریخ و زمانی که خزنده ما بک‌لینک را نخستین بار پیدا کرد
در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - lostنوع: string | null
_date تاریخ و ساعت از دست رفتن آخرین بک‌لینک این صفحه
تاریخ و ساعتی را نشان می‌دهد که خزنده ما صفحه را بازدید کرده و صفحه با کد وضعیت 4xx یا 5xx پاسخ داده است یا آخرین بک‌لینک حذف شده است
در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2017-01-24 13:20:59 +00:00 - rankنوع: integer | null
- referringنوع: integer | null قالب: int64
_domains تعداد دامنه‌های ارجاع‌دهنده را نشان می‌دهد
- referringنوع: integer | null قالب: int64
_domains _nofollow تعداد دامنه‌هایی که دست‌کم یک پیوند nofollow به
pageاشاره می‌کنند - 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 - propertyنوع: integer | null قالب: int64
Name Signed 64-bit integers (long type).
- referringنوع: object | null
_links _platform _types - 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 - propertyنوع: integer | null قالب: int64
Name Signed 64-bit integers (long type).
- referringنوع: integer | null قالب: int64
_main _domains تعداد دامنه‌های اصلی ارجاع‌دهنده را نشان می‌دهد
- referringنوع: integer | null قالب: int64
_main _domains _nofollow Signed 64-bit integers (long type).
- referringنوع: integer | null قالب: int64
_pages تعداد صفحه‌هایی را نشان می‌دهد که به
pageاشاره می‌کنند - referringنوع: integer | null قالب: int64
_pages _nofollow تعداد صفحه‌های ارجاع‌دهنده‌ای که دست‌کم یک پیوند nofollow به
pageاشاره می‌کنند - referringنوع: integer | null قالب: int64
_subnets تعداد زیرشبکه‌های ارجاع‌دهنده
- prevنوع: string | null
_visited تاریخ پیش از جدیدترین تاریخی که خزنده ما از صفحه بازدید کرد
در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2017-01-24 13:20:59 +00:00 - serverنوع: string | null
نسخه سرور
- sizeنوع: integer | null
اندازه صفحه را بر حسب بایت نشان می‌دهد
- statusنوع: integer | null
_code کد وضعیت عمومی
فهرست کامل کدهای پاسخ را می‌توانید اینجا بیابید
نکته: اکیداً توصیه می‌کنیم سامانه‌ای لازم برای مدیریت شرایط استثنایی یا خطاهای مرتبط طراحی کنید - tldنوع: string | null
- typeنوع: string | null
نوع عنصر
- itemsنوع: integer | null قالب: int64
_count تعداد موارد در آرایه
items - targetنوع: string | null
targetدر آرایه 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/domain_pages/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "forbes.com",
"limit": 5,
"filters": [
[
"page_summary.backlinks",
">",
5
],
"and",
[
"page",
"like",
"%sites%"
]
]
}
]'
{
"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,
"main_domain": null,
"domain": null,
"tld": null,
"page": null,
"ip": null,
"first_visited": null,
"prev_visited": null,
"fetch_time": null,
"status_code": null,
"location": null,
"size": null,
"encoded_size": null,
"content_encoding": null,
"media_type": null,
"server": null,
"meta": {
"0": "[",
"1": "M",
"2": "a",
"3": "x",
"4": " ",
"5": "D",
"6": "e",
"7": "p",
"8": "t",
"9": "h",
"10": " ",
"11": "E",
"12": "x",
"13": "c",
"14": "e",
"15": "e",
"16": "d",
"17": "e",
"18": "d",
"19": "]",
"social_media_tags": "[Max Depth Exceeded]"
},
"page_summary": {
"0": "[",
"1": "M",
"2": "a",
"3": "x",
"4": " ",
"5": "D",
"6": "e",
"7": "p",
"8": "t",
"9": "h",
"10": " ",
"11": "E",
"12": "x",
"13": "c",
"14": "e",
"15": "e",
"16": "d",
"17": "e",
"18": "d",
"19": "]",
"referring_main_domains_nofollow": "[Max Depth Exceeded]",
"referring_links_tld": "[Max Depth Exceeded]",
"referring_links_types": "[Max Depth Exceeded]",
"referring_links_attributes": "[Max Depth Exceeded]",
"referring_links_platform_types": "[Max Depth Exceeded]",
"referring_links_semantic_locations": "[Max Depth Exceeded]",
"referring_links_countries": "[Max Depth Exceeded]"
}
}
]
}
]
}
]
}