DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
رقبای SERP
دامنه‌هایی که برای مجموعه‌ای از keywords در کنار شما رتبه می‌گیرند، همراه با تعداد اشتراک‌شان. se_type، seed_keywords، total_count، items_count و items را برمی‌گرداند. پاسخ در پاکت DataForSEO قرار می‌گیرد: داده‌ها در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده نیز همچنان HTTP 200 برمی‌گرداند. ⚠️ این‌ها رقبای جستجو هستند که با رتبه‌های مشترک تعیین می‌شوند. معادل گراف لینک post_dataforseo_backlinks_competitors_live است و این دو فهرست اغلب با هم اختلاف دارند — که خودش آموزنده است.
مرجع قیمت‌گذاری
- اندازه‌گیری: هزینه گزارش‌شده پاسخ.
- برآورد درخواست مرجع: 0.0192 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: array (object | null)[]
- filtersنوع: array (object | null)[] | null
آرایه پارامترهای فیلتر نتایج
فیلد اختیاری
می‌توانید چند فیلتر را هم‌زمان اضافه کنید (حداکثر 8 فیلتر)
باید بین شرایط یک عملگر منطقیandیاorبگذارید
عملگرهای پشتیبانی‌شده:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,match,not_match,ilike,not_ilike,like,not_like
می‌توانید از عملگر%همراه باlikeوnot_likeو همچنینilikeوnot_ilikeبرای تطبیق هر رشته با صفر یا بیشتر کاراکتر استفاده کنید
مثال:["median_position","in",[1,10]][["median_position","in",[1,10]],"and",["domain","not_like","%wikipedia.org%"]][["domain","not_like","%wikipedia.org%"],
"and",
[["relevant_serp_items",">",0],"or",["median_position","in",[1,10]]]]
برای اطلاعات بیشتر درباره فیلترها به Dataforseo Labs - Filters یا راهنمای مرکز راهنمایی مراجعه کنیدشیء خالی - includeنوع: boolean | null
_subdomains نشان می‌دهد آیا زیردامنه‌ها در جستجو لحاظ می‌شوند
فیلد اختیاری
اگر رویfalseتنظیم شود، زیردامنه‌ها نادیده گرفته می‌شوند
مقدار پیش‌فرض:true - itemنوع: array string[] | null
_types نوع نتایج جستجو
نوع نتایج جستجوی موجود در پاسخ را نشان می‌دهد
فیلد اختیاریمقادیر ممکن:
["organic", "paid", "featured_snippet", "local_pack"]
مقدار پیش‌فرض:["organic", "paid"] - keywordsنوع: array string[]
آرایه کلمات کلیدی
فیلد الزامی
نتایج بر اساس کلمات کلیدی که در این آرایه تعیین می‌کنید خواهد بود
کدگذاری UTF-8؛
کلمات کلیدی به حروف کوچک تبدیل می‌شوند؛
می‌توانید حداکثر 200 کلمه کلیدی تعیین کنیددرباره قواعد و محدودیت‌های فیلدهای
keywordوkeywordsدر APIهای DataForSEO در این مقاله مرکز راهنمایی بیشتر بدانید - languageنوع: string | null
_code شناسه یکتای زبان
فیلد الزامی اگر تعیین نکنیدlanguage_name
توجه: بایدlanguage_nameیاlanguage_codeرا مشخص کنید
می‌توانید فهرست زبان‌های موجود را همراه با پارامترهایlanguage_codeآن‌ها با ارسال درخواست جداگانه به نشانی زیر دریافت کنیدhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
مثال:en - languageنوع: string
_name نام کامل زبان
فیلد الزامی اگر تعیین نکنیدlanguage_code
توجه: بایدlanguage_nameیاlanguage_codeرا مشخص کنید
می‌توانید فهرست زبان‌های موجود را همراه با پارامترهایlanguage_nameآن‌ها با ارسال درخواست جداگانه به نشانی زیر دریافت کنیدhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
مثال:English - limitنوع: integer | null
حداکثر تعداد دامنه‌های برگشتی
فیلد اختیاری
مقدار پیش‌فرض:100
حداکثر مقدار:1000 - locationنوع: integer
_code شناسه یکتای مکان
فیلد الزامی اگر تعیین نکنیدlocation_name
توجه: بایدlocation_nameیاlocation_codeرا مشخص کنید
می‌توانید فهرست مکان‌های موجود را همراه با پارامترهایlocation_codeآن‌ها با ارسال درخواست جداگانه به نشانی زیر دریافت کنیدhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
مثال:2840 - locationنوع: string
_name نام کامل مکان
فیلد الزامی اگر تعیین نکنیدlocation_code
توجه: بایدlocation_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- نتایج به ترتیب نزولی مرتب می‌شوند
ویرگول به‌عنوان جداکننده استفاده می‌شود
مثال:["avg_position,asc"]
قاعده پیش‌فرض:["rating,desc"]
توجه داشته باشید که در یک درخواست نمی‌توان بیش از سه قاعده مرتب‌سازی تعیین کرد
برای جدا کردن چند قاعده مرتب‌سازی از ویرگول استفاده کنید
مثال:["avg_position,asc","etv,desc"] - tagنوع: string | null
شناسه وظیفه تعریف‌شده توسط کاربر
فیلد اختیاری
محدودیت کاراکتر 255 است
می‌توانید از این پارامتر برای شناسایی وظیفه و تطبیق آن با نتیجه استفاده کنید
مقدارtagمشخص‌شده را در شیءdataپاسخ پیدا می‌کنید
- نوع: object | null · Response36Afe1097B20_DataforseoLabsGoogleSerpCompetitorsLiveResponseInfo200
- نوع: number | null قالب: doublecost
هزینه کل وظایف، دلار آمریکا
- نوع: integer | nullstatus
_code کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید
- نوع: string | nullstatus
_message پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید
- نوع: array (object | null)[] | nulltasks
آرایه‌ای از وظایف
- نوع: object | null · Response36Afe1097B20_DataforseoLabsGoogleSerpCompetitorsLiveTaskInfo
- 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
شامل رقبای کشف‌شده SERP و داده‌های مرتبط است
- avgنوع: number | null قالب: float
_position میانگین موقعیت دامنه برای کلیدواژه‌های مشخص‌شده
میانگین حسابی مقادیر در آرایهkeywords_positions - domainنوع: string | null
نام دامنه رقیب SERP کشف‌شده
- etvنوع: number | null
- keywordsنوع: integer | null قالب: int64
_count تعداد کلیدواژه‌های مشخص‌شده‌ای که دامنه برای آن‌ها در SERP موقعیت دارد
- keywordsنوع: object | null
_positions موقعیت‌های کلیدواژه
موقعیت‌های SERP که دامنه مرتبط برای کلیدواژه‌های مشخص‌شده در SERP دارد- propertyنوع: array (integer | null)[] | null
Name
- medianنوع: number | null
_position موقعیت میانه دامنه برای کلیدواژه‌های مشخص‌شده
میانه مقادیر در آرایهkeywords_positions - ratingنوع: number | null
فاصله میان بیشترین موقعیت ممکن و موقعیت واقعی کلیدواژه‌ها
نرخ نمایش نسبی دامنه در SERP برای کلیدواژه‌های مشخص‌شده را نشان می‌دهد
به‌صورت sum(100-keywords_positions) محاسبه می‌شود - relevantنوع: integer | null
_serp _items تعداد عناصر SERP مرتبط با دامنه
تعداد نتایج جستجو در SERP را نشان می‌دهد که برای کلیدواژه‌های مشخص‌شده به دامنه مربوط هستند - seنوع: string | null
_type نوع موتور جستجو
- visibilityنوع: number | null
نرخ نمایش در SERP
نرخ نمایش وب‌سایت را بر اساس موقعیت‌های SERP کلیدواژه‌های مشخص‌شده نشان می‌دهد
کلیدواژه‌های با موقعیت در بازه 1 تا 10 به‌ترتیب شاخص نمایش 1 تا 0.1 می‌گیرند
کلیدواژه‌های با موقعیت در بازه 11 تا 20 شاخص نمایش ثابت 0.05 دارند
کلیدواژه‌های با موقعیت از 20 تا 100 شاخص نمایش برابر 0 دارند
- itemsنوع: integer | null قالب: int64
_count تعداد نتایج بازگردانده‌شده در آرایه
items - languageنوع: string | null
_code کد زبان در آرایه POST
اگر داده‌ای نباشد، مقدارnullاست - locationنوع: integer | null
_code کد مکان در آرایه POST
اگر داده‌ای نباشد، مقدارnullاست - seنوع: string | null
_type نوع موتور جستجو
- seedنوع: array (string | null)[] | null
_keywords کلیدواژه‌های مشخص‌شده در درخواست
کلیدواژه با %## رمزگشایی‌شده برگردانده می‌شود (کاراکتر '+' نیز به فاصله رمزگشایی می‌شود) - 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/serp_competitors/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keywords": [
"phone"
],
"language_name": "English",
"location_code": 2840,
"item_types": [
"organic"
],
"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": [
{
"se_type": null,
"seed_keywords": [
null
],
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"domain": null,
"avg_position": null,
"median_position": null,
"rating": null,
"etv": null,
"keywords_count": null,
"visibility": null,
"relevant_serp_items": null,
"keywords_positions": null
}
]
}
]
}
]
}