DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
صفحه‌های مرتبط
کدام صفحه‌های یک سایت target رتبه‌های آن را به دست می‌آورند، مرتب‌شده بر اساس ترافیکی که می‌آورند. با limit، offset و offset_token صفحه‌بندی کنید؛ پس از صفحه‌های نخست از توکن استفاده کنید. پاسخ در پاکت DataForSEO قرار می‌گیرد: داده‌ها در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده نیز همچنان HTTP 200 برمی‌گرداند. از آن برای یافتن صفحه‌هایی استفاده کنید که ارزش دفاع یا گسترش دارند. برای کلیدواژه‌های پشت آن‌ها از post_dataforseo_labs_google_kw_for_site_live استفاده کنید؛ و برای صفحه‌هایی که به‌جای رتبه، لینک کسب می‌کنند، post_dataforseo_backlinks_domain_pages_summary_live.
مرجع قیمت‌گذاری
- اندازه‌گیری: هزینه گزارش‌شده پاسخ.
- برآورد درخواست مرجع: 0.015 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: array (object | null)[]
- filtersنوع: array (object | null)[] | null
آرایه پارامترهای فیلتر نتایج
فیلد اختیاری
می‌توانید چند فیلتر را هم‌زمان اضافه کنید (حداکثر 8 فیلتر)
باید بین شرایط یک عملگر منطقیandیاorبگذارید
عملگرهای پشتیبانی‌شده:regex,not_regex,<,<=,>,>=,=,<>,in,not_inمثال:
["metrics.paid.count",">",0][["metrics.organic.count",">",50],"and",["metrics.organic.pos_1","<>",0]][[""metrics.organic.count",">",50"],
"and",
[["metrics.organic.pos_1","<>",0],"or",["metrics.organic.pos_2_3","<>",0]]]
برای اطلاعات بیشتر درباره فیلترها به Dataforseo Labs - Filters یا راهنمای مرکز راهنمایی مراجعه کنیدشیء خالی - historicalنوع: string | null
_serp _mode حالت جمع‌آوری داده
فیلد اختیاری
می‌توانید از این فیلد برای فیلتر نتایج استفاده کنید؛
انواع فیلتر ممکن:live— بازگرداندن معیارها برای SERPهایی کهtargetتعیین‌شده در آن‌ها در حال حاضر نتایج رتبه‌بندی دارد؛lost— بازگرداندن معیارها برای SERPهایی کهtargetتعیین‌شده پیش‌تر نتایج رتبه‌بندی داشت، اما در آخرین بررسی آن‌ها را نداشت؛all— بازگرداندن معیارها برای هر دو نوع SERP.
مقدار پیش‌فرض:live - ignoreنوع: boolean | null
_synonyms نادیده گرفتن کلمات کلیدی بسیار مشابه
فیلد اختیاری
اگر رویtrueتنظیم شود، فقط کلمات کلیدی اصلی برگردانده می‌شوند و همه کلمات کلیدی بسیار مشابه حذف می‌شوند؛
مقدار پیش‌فرض:false - includeنوع: boolean | null
_clickstream _data شامل کردن یا کنار گذاشتن داده‌های معیارهای مبتنی بر کلیک‌استریم در نتیجه
فیلد اختیاری
اگر پارامتر رویtrueتنظیم شود، فیلدهایclickstream_etv،clickstream_gender_distributionوclickstream_age_distributionرا همراه با داده‌های کلیک‌استریم در پاسخ دریافت می‌کنید
مقدار پیش‌فرض:false
با فعال بودن این پارامتر، دو برابر قیمت درخواست از شما دریافت میشوددرباره نحوه محاسبه معیارهای مبتنی بر کلیک‌استریم در این مقاله مرکز راهنمایی بیشتر بدانید
- itemنوع: array string[] | null
_types نمایش نتایج بر اساس نوع آیتم
فیلد اختیاری
نوع نتایج جستجوی موجود در پاسخ را نشان میدهدتوجه: اگر آرایه
item_typesشامل انواع آیتمی متفاوت ازorganicباشد، نتایج بر اساس نخستین نوع آیتم در آرایه مرتب می‌شوند؛ نمی‌توانید نتایج را بر اساس انواع نتایج جستجویی که در پاسخ نیامده‌اند مرتب و فیلتر کنید.مقادیر ممکن:
["organic", "paid", "featured_snippet", "local_pack"]
مقدار پیش‌فرض:["organic", "paid"] - languageنوع: string | null
_code کد زبان
فیلد اختیاری
اگر از این فیلد استفاده کنید، نیازی به تعیینlanguage_nameندارید
فهرست زبان‌های موجود همراه باlanguage_codeآن‌ها را می‌توانید با ارسال یک درخواست جداگانه بهhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesدریافت کنید
برای دریافت نتایج همه زبان‌های موجود، این فیلد را نادیده بگیرید
نمونه:en - languageنوع: string | null
_name نام کامل زبان
فیلد اختیاری
اگر از این فیلد استفاده کنید، نیازی به تعیینlanguage_codeندارید
فهرست زبان‌های موجود همراه باlanguage_nameآن‌ها را می‌توانید با ارسال یک درخواست جداگانه بهhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesدریافت کنید
برای دریافت نتایج همه زبان‌های موجود، این فیلد را نادیده بگیرید
نمونه:English - limitنوع: integer | null
حداکثر تعداد صفحات برگشتی
فیلد اختیاری
مقدار پیش‌فرض:100
حداکثر مقدار:1000 - locationنوع: integer | null
_code کد مکان
فیلد اختیاری
اگر از این فیلد استفاده کنید، نیازی به تعیینlocation_nameندارید
فهرست مکان‌های موجود همراه باlocation_codeآن‌ها را می‌توانید با ارسال یک درخواست جداگانه بهhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesدریافت کنید
برای دریافت نتایج همه مکان‌های موجود، این فیلد را نادیده بگیرید
نمونه:2840 - locationنوع: string | null
_name نام کامل مکان
فیلد اختیاری
اگر از این فیلد استفاده کنید، نیازی به تعیینlocation_codeندارید
فهرست مکان‌های موجود همراه باlocation_nameآن‌ها را می‌توانید با ارسال یک درخواست جداگانه بهhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesدریافت کنید
برای دریافت نتایج همه مکان‌های موجود، این فیلد را نادیده بگیرید
نمونه:United Kingdom - offsetنوع: integer | null
آفست در آرایه نتایج صفحات برگشتی
فیلد اختیاری
مقدار پیش‌فرض:0
اگر مقدار10را تعیین کنید، ده صفحه نخست در آرایه نتایج حذف می‌شود و داده‌ها برای صفحات بعدی ارائه می‌شود - orderنوع: array string[] | null
_by قواعد مرتب‌سازی نتایج
فیلد اختیاری
می‌توانید از همان مقادیر آرایهfiltersبرای مرتب‌سازی نتایج استفاده کنید
انواع مرتب‌سازی ممکن:asc- نتایج به ترتیب صعودی مرتب می‌شوندdesc- نتایج به ترتیب نزولی مرتب می‌شوند
برای تعیین نوع مرتب‌سازی از ویرگول استفاده کنید
مثال:["metrics.paid.etv,asc"]
توجه: در یک درخواست نمی‌توان بیش از سه قاعده مرتب‌سازی تعیین کرد
برای جدا کردن چند قاعده مرتب‌سازی از ویرگول استفاده کنید
مثال:["metrics.organic.etv,desc","metrics.paid.count,asc"]قاعده پیش‌فرض:
["metrics.organic.count,desc"]
توجه: اگر آرایهitem_typesشامل انواع آیتمی متفاوت ازorganicباشد، نتایج بر اساس نخستین نوع آیتم در آرایه مرتب می‌شوند - tagنوع: string | null
شناسه وظیفه تعریف‌شده توسط کاربر
فیلد اختیاری
محدودیت کاراکتر 255 است
می‌توانید از این پارامتر برای شناسایی وظیفه و تطبیق آن با نتیجه استفاده کنید
مقدارtagمشخص‌شده را در شیءdataپاسخ پیدا می‌کنید - targetنوع: string
دامنه
فیلد الزامی
نام دامنه وب‌سایت هدف
دامنه باید بدونhttps://وwww.تعیین شود
- نوع: object | null · Response36Afe1097B20_DataforseoLabsGoogleRelevantPagesLiveResponseInfo200
- نوع: number | null قالب: doublecost
هزینه کل وظایف، دلار آمریکا
- نوع: integer | nullstatus
_code کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید
- نوع: string | nullstatus
_message پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید
- نوع: array (object | null)[] | nulltasks
آرایه‌ای از وظایف
- نوع: object | null · Response36Afe1097B20_DataforseoLabsGoogleRelevantPagesLiveTaskInfo
- 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
صفحه‌های مرتبط و داده‌های وابسته
- metricsنوع: object | null
رتبه‌بندی‌ها و معیارهای ترافیک برای صفحه مرتبط
- propertyنوع: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
Name - clickstreamنوع: object | null
_age _distribution - propertyنوع: integer | null قالب: int64
Name Signed 64-bit integers (long type).
- clickstreamنوع: number | null قالب: double
_etv حجم ترافیک تخمینی بر اساس داده‌های clickstream
به‌صورت حاصل‌ضرب نرخ کلیک و مقادیر حجم جستجوی clickstream همه کلیدواژه‌هایی که دامنه برای آن‌ها رتبه دارد محاسبه می‌شود
برای دریافت نتایج این فیلد، پارامترinclude_clickstream_dataباید رویtrueتنظیم شود
درباره نحوه محاسبه این معیار در این مقاله مرکز راهنما بیشتر بدانید - clickstreamنوع: object | null
_gender _distribution - propertyنوع: integer | null قالب: int64
Name Signed 64-bit integers (long type).
- countنوع: integer | null قالب: int64
تعداد کل SERPهای ارگانیکی که دامنه یا زیردامنه را شامل می‌شوند
- estimatedنوع: number | null
_paid _traffic _cost هزینه تخمینی تبدیل ترافیک جستجوی ارگانیک به ترافیک پرداختی
هزینه ماهانه تخمینی (به دلار آمریکا) را برای اجرای تبلیغات همه کلیدواژه‌های دسته‌بندی‌ای که دامنه یا زیردامنه برای آن‌ها رتبه دارد نشان می‌دهد
این معیار به‌صورت حاصل‌ضرب مقادیرetvارگانیک وcpcپرداختی محاسبه می‌شود و هزینه جذب حجم تخمینی ترافیک ارگانیک ماهانه را از طریق تبلیغات PPC در جستجوی Google نشان می‌دهد
درباره نحوه محاسبه این معیار در این مقاله مرکز راهنما بیشتر بدانید - etvنوع: number | null
- isنوع: integer | null
_down رتبه کاهش یافت
نشان می‌دهد چند عنصر رتبه‌بندی‌شده از هدف مشخص‌شده کاهش رتبه داشته‌اند - isنوع: integer | null
_lost عناصر رتبه‌بندی‌شده از دست‌رفته
نشان می‌دهد چند عنصر رتبه‌بندی‌شده از هدف مشخص‌شده پیش‌تر در SERP نمایش داده می‌شدند اما در آخرین بررسی یافت نشدند - isنوع: integer | null
_new تعداد عناصر رتبه‌بندی‌شده جدید
نشان می‌دهد چند عنصر رتبه‌بندی‌شده جدید برای هدف مشخص‌شده یافت شده است - isنوع: integer | null
_up رتبه افزایش یافت
نشان می‌دهد چند عنصر رتبه‌بندی‌شده از هدف مشخص‌شده افزایش رتبه داشته‌اند - posنوع: integer | null
_1 تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #1 دارد
- posنوع: integer | null
_11 _20 تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #11-20 دارد
- posنوع: integer | null
_2 _3 تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #2-3 دارد
- posنوع: integer | null
_21 _30 تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #21-30 دارد
- posنوع: integer | null
_31 _40 تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #31-40 دارد
- posنوع: integer | null
_4 _10 تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #4-10 دارد
- posنوع: integer | null
_41 _50 تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #41-50 دارد
- posنوع: integer | null
_51 _60 تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #51-60 دارد
- posنوع: integer | null
_61 _70 تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #61-70 دارد
- posنوع: integer | null
_71 _80 تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #71-80 دارد
- posنوع: integer | null
_81 _90 تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #81-90 دارد
- posنوع: integer | null
_91 _100 تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #91-100 دارد
- pageنوع: string | null
_address نشانی URL مطلق صفحه مرتبط
- seنوع: string | null
_type نوع موتور جستجو
- itemsنوع: integer | null قالب: int64
_count تعداد نتایج بازگردانده‌شده در آرایه
items - languageنوع: string | null
_code کد زبان در آرایه POST
اگر داده‌ای نباشد، مقدارnullاست - locationنوع: integer | null
_code کد مکان در آرایه POST
اگر داده‌ای نباشد، مقدارnullاست - seنوع: string | null
_type نوع موتور جستجو
- 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/dataforseo_labs/google/relevant_pages/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "amazon.com",
"language_name": "English",
"location_code": 2840,
"filters": [
[
"metrics.organic.pos_1",
"<>",
0
],
"or",
[
"metrics.organic.pos_2_3",
"<>",
0
]
],
"limit": 3
}
]'
{
"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": [
{
"se_type": null,
"target": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"page_address": null,
"metrics": null
}
]
}
]
}
]
}