DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
رقبا
سایت‌هایی که دامنه‌های ارجاع‌دهنده را با یک target شریک‌اند، مرتب‌شده بر اساس تعداد اشتراک. هر ردیف target، rank و intersections را می‌دهد — شمار دامنه‌های پیونددهنده مشترک. main_domain، exclude_large_domains و exclude_internal_backlinks تعیین می‌کنند چه چیزی شمرده شود. این‌ها رقبای گراف لینک‌اند، نه رقبای جستجو؛ برای دومی از post_dataforseo_labs_google_serp_competitors_live استفاده کنید. برای دیدن دامنه‌های مشترک واقعی از post_dataforseo_backlinks_domain_intersection_live استفاده کنید.
مرجع قیمت‌گذاری
- اندازه‌گیری: هزینه گزارش‌شده پاسخ.
- برآورد درخواست مرجع: 0.0276 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: array (object | null)[]
- excludeنوع: boolean | null
_internal _backlinks نشان می‌دهد آیا بک‌لینک‌های داخلی از زیردامنه‌ها به
targetاز نتایج مستثنی می‌شوند
فیلد اختیاری
اگر رویtrueتنظیم شود، نتایج داده‌های مربوط به بک‌لینک‌های داخلی از زیردامنه‌های همان دامنهtargetرا شامل نمی‌شوند
اگر رویfalseتنظیم شود، پیوندهای داخلی در نتایج گنجانده می‌شوند
مقدار پیش‌فرض:true - excludeنوع: boolean | null
_large _domains نشان می‌دهد آیا دامنه بزرگ در نتایج ظاهر می‌شود
فیلد اختیاری
اگر رویtrueتنظیم شود، نتایج دامنه بزرگ (google.com، amazon.com و غیره) حذف می‌شوند؛
مقدار پیش‌فرض: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برای تطبیق هر رشته صفر یا بیشتر نویسه به کار ببرید
مثال:["rank",">","100"][["target","like","%forbes%"],
"and",
[["rank",">","100"],"or",["intersections",">","5"]]]شیء خالی - limitنوع: integer | null
حداکثر تعداد دامنه‌های برگشتی
فیلد اختیاری
مقدار پیش‌فرض:100
حداکثر مقدار:1000 - mainنوع: boolean | null
_domain نشان می‌دهد آیا فقط دامنه اصلی
targetدر جستجو گنجانده می‌شود
فیلد اختیاری
اگر رویtrueتنظیم شود، فقط دامنه اصلی در جستجو گنجانده می‌شود؛
مقدار پیش‌فرض:true - offsetنوع: integer | null
آفست در آرایه نتایج دامنه‌های برگردانده‌شده
فیلد اختیاری
مقدار پیش‌فرض:0
اگر مقدار10را مشخص کنید، ده دامنه اول در آرایه نتایج حذف می‌شود و داده‌ها برای صفحات بعدی ارائه می‌شوند - orderنوع: array string[] | null
_by قواعد مرتب‌سازی نتایج
فیلد اختیاری
می‌توانید از همان مقادیر آرایهfiltersبرای مرتب‌سازی نتایج استفاده کنید
انواع مرتب‌سازی ممکن:asc— نتایج به ترتیب صعودی مرتب می‌شوندdesc— نتایج به ترتیب نزولی مرتب می‌شوند
برای تعیین نوع مرتب‌سازی از ویرگول استفاده کنید
مثال:["rank,desc"]
توجه کنید که در یک درخواست نمی‌توان بیش از سه قاعده مرتب‌سازی تعیین کرد
باید چند قاعده مرتب‌سازی را با ویرگول جدا کنید
مثال:["intersections,desc","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.مشخص شود
صفحه باید با URL مطلق (شاملhttp://یاhttps://) مشخص شود
- نوع: object | null · Response36Afe1097B20_BacklinksCompetitorsLiveResponseInfo200
- نوع: number | null قالب: doublecost
هزینه کل وظایف، دلار آمریکا
- نوع: integer | nullstatus
_code کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید
- نوع: string | nullstatus
_message پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید
- نوع: array (object | null)[] | nulltasks
آرایه‌ای از وظایف
- نوع: object | null · Response36Afe1097B20_BacklinksCompetitorsLiveTaskInfo
- 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
آرایه آیتم‌ها
- intersectionsنوع: integer | null
تعداد اشتراک بک‌لینک‌ها با
targetمشخص‌شده در آرایه POST را نشان می‌دهد - rankنوع: integer | null
- targetنوع: string | null
دامنه رقیب
- typeنوع: string | null
نوع عنصر
- itemsنوع: integer | null قالب: int64
_count تعداد موارد در آرایه
items - 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/competitors/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "dataforseo.com",
"filters": [
"rank",
">",
100
],
"order_by": [
"rank,desc"
],
"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": [
{
"total_count": null,
"items_count": null,
"items": [
{
"type": null,
"target": null,
"rank": null,
"intersections": null
}
]
}
]
}
]
}