DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
فناوری‌های تجمیع
شمارش، نه دامنه: چند سایت با یک پرس‌وجوی فناوری مطابقت دارند، با تفکیک بر اساس گروه، دسته و فناوری. total_count، items_count، offset و items را برمی‌گرداند، در حالی که internal_groups_list_limit، internal_categories_list_limit، internal_technologies_list_limit و internal_list_limit هر یک سطح تودرتوی متفاوتی را محدود می‌کنند — هر چهار را تنظیم کنید وگرنه پاسخ به‌سرعت بزرگ می‌شود. برای خود دامنه‌ها و نه شمارش‌شان، از post_dataforseo_domains_tech_domains_by_technology_live استفاده کنید.
مرجع قیمت‌گذاری
- اندازه‌گیری: هزینه گزارش‌شده پاسخ.
- برآورد درخواست مرجع: 0.012 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: array (object | null)[]
- categoryنوع: string
- filtersنوع: array (object | null)[] | null
آرایه پارامترهای فیلتر نتایج
فیلد اختیاری
می‌توانید چند فیلتر را هم‌زمان اضافه کنید (حداکثر 8 فیلتر)
باید بین شرایط یک عملگر منطقیandیاorبگذارید
عملگرهای پشتیبانی‌شده:<,<=,>,>=,=,<>,in,not_in,like,not_like
می‌توانید از عملگر%همراه باlikeوnot_likeبرای تطبیق هر رشته با صفر یا بیشتر کاراکتر استفاده کنید
می‌توانید از پارامترهای زیر برای فیلتر کردن نتایج استفاده کنید:domain_rank,last_visited,country_iso_code,language_code,content_language_code
توجه: همه پارامترهای فیلتر ازdomain_technology_itemنقطه پایانی domain_technologies گرفته می‌شوند؛
مثال:[["country_iso_code","=","US"],برای اطلاعات بیشتر درباره فیلترها به Domain Analytics Technologies API - Filters مراجعه کنید
"and",
["domain_rank",">",800]]شیء خالی - groupنوع: string
- internalنوع: integer | null
_categories _list _limit حداکثر تعداد دسته‌های فناوری برگشتی در همان گروه
فیلد اختیاری
می‌توانید از این فیلد برای محدود کردن تعداد آیتم‌های دارای"category"یکسان در نتایج استفاده کنید
مقدار پیش‌فرض:5
حداقل مقدار:1
حداکثر مقدار:10000 - internalنوع: integer | null
_groups _list _limit حداکثر تعداد گروه‌های فناوری برگشتی
فیلد اختیاری
می‌توانید از این فیلد برای محدود کردن تعداد آیتم‌های دارای"group"یکسان در نتایج استفاده کنید
مقدار پیش‌فرض:5
حداقل مقدار:1
حداکثر مقدار:10000 - internalنوع: integer | null
_list _limit حداکثر تعداد آیتم‌های دارای
"category"،"group"و"technology"یکسان
فیلد اختیاری
در صورت استفاده از این فیلد، مقادیر تعیین‌شده درinternal_groups_list_limit،internal_categories_list_limitوinternal_technologies_list_limitنادیده گرفته می‌شوند؛
می‌توانید از این فیلد برای محدود کردن تعداد آیتم‌های دارای"category"،"group"یا"technology"یکسان استفاده کنید
مقدار پیش‌فرض:10
حداقل مقدار:1
حداکثر مقدار:10000 - internalنوع: integer | null
_technologies _list _limit حداکثر تعداد فناوری‌های برگشتی در همان دسته
فیلد اختیاری
می‌توانید از این فیلد برای محدود کردن تعداد آیتم‌های دارای"technology"یکسان در نتایج استفاده کنید
مقدار پیش‌فرض:10
حداقل مقدار:1
حداکثر مقدار:10000 - keywordنوع: string
کلمه کلیدی هدف در meta keywords دامنه
فیلد الزامی اگرgroup،categoryیاtechnologyرا تعیین نکنید
باید دست‌کم یک فیلد (group,category,keyword,technology) تعیین شود
کدگذاری UTF-8
مثال:"seo"درباره قواعد و محدودیت‌های فیلدهایkeywordوkeywordsدر APIهای DataForSEO در این مقاله مرکز راهنمایی بیشتر بدانید - limitنوع: integer | null
حداکثر تعداد فناوری‌های برگشتی
فیلد اختیاری
مقدار پیش‌فرض:100
حداکثر مقدار:10000 - modeنوع: string | null
حالت جستجو
فیلد اختیاری
انواع حالت جستجوی ممکن:as_is- جستجوی نتایجی که دقیقاً با شناسه‌های گروه، شناسه‌های دسته یا نام‌های فناوری مشخص‌شده مطابقت دارندentry- جستجوی نتایجی که با بخشی از شناسه‌های گروه، شناسه‌های دسته یا نام‌های فناوری مشخص‌شده مطابقت دارند
مقدار پیش‌فرض:as_is - offsetنوع: integer | null
آفست در آرایه نتایج دامنه‌های برگشتی
فیلد اختیاری
مقدار پیش‌فرض:0
حداکثر مقدار:9999
اگر مقدار10را تعیین کنید، ده فناوری نخست در آرایه نتایج حذف می‌شود و داده‌ها برای فناوری‌های بعدی ارائه می‌شود - orderنوع: array string[] | null
_by قواعد مرتب‌سازی نتایج
فیلد اختیاری
می‌توانید از مقادیر زیر برای مرتب‌سازی نتایج استفاده کنید:groups_count,categories_count,technologies_count
انواع مرتب‌سازی ممکن:asc- نتایج به ترتیب صعودی مرتب می‌شوندdesc- نتایج به ترتیب نزولی مرتب می‌شوند
برای تعیین نوع مرتب‌سازی از ویرگول استفاده کنید
مثال:["groups_count,desc"]
توجه داشته باشید که در یک درخواست نمی‌توان بیش از سه قاعده مرتب‌سازی تعیین کرد
برای جدا کردن چند قاعده مرتب‌سازی از ویرگول استفاده کنید
مثال:["groups_count,desc","technologies_count,desc"]
مقدار پیش‌فرض:["groups_count,desc","categories_count,desc","technologies_count,desc"] - tagنوع: string | null
شناسه وظیفه تعریف‌شده توسط کاربر
فیلد اختیاری
محدودیت کاراکتر 255 است
می‌توانید از این پارامتر برای شناسایی وظیفه و تطبیق آن با نتیجه استفاده کنید
مقدارtagمشخص‌شده را در شیءdataپاسخ پیدا می‌کنید - technologyنوع: string
- نوع: object | null · Response36Afe1097B20_DomainAnalyticsTechnologiesAggregationTechnologiesLiveResponseInfo200
- نوع: number | null قالب: doublecost
هزینه کل وظایف، دلار آمریکا
- نوع: integer | nullstatus
_code کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید
- نوع: string | nullstatus
_message پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید
- نوع: array (object | null)[] | nulltasks
آرایه‌ای از وظایف
- نوع: object | null · Response36Afe1097B20_DomainAnalyticsTechnologiesAggregationTechnologiesLiveTaskInfo
- 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
آرایه items
- categoriesنوع: integer | null قالب: int64
_count تعداد دسته‌بندی‌های فناوری
تعداد دامنه‌هایی که با پارامترهای تعیین‌شده شما مطابقت دارند و از فناوری‌هایcategoryمشخص‌شده استفاده می‌کنند - categoryنوع: string | null
شناسه دسته‌بندی فناوری
- groupنوع: string | null
شناسه گروه فناوری
- groupsنوع: integer | null قالب: int64
_count تعداد گروه‌های فناوری
تعداد دامنه‌هایی که با پارامترهای تعیین‌شده شما مطابقت دارند و از فناوری‌هایgroupمشخص‌شده استفاده می‌کنند - technologiesنوع: integer | null قالب: int64
_count تعداد فناوری‌ها
تعداد دامنه‌هایی که با پارامترهای تعیین‌شده شما مطابقت دارند و ازtechnologyمشخص‌شده استفاده می‌کنند - technologyنوع: string | null
نام فناوری
- typeنوع: string | null
نوع عنصر
- itemsنوع: integer | null قالب: int64
_count تعداد نتایج بازگردانده‌شده در آرایه
items - offsetنوع: integer | null
آفست در آرایه نتایج دامنه‌های برگردانده‌شده
- 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/domain_analytics/technologies/aggregation_technologies/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"mode": "entry",
"technology": "Nginx",
"keyword": "WordPress",
"filters": [
[
"country_iso_code",
"=",
"US"
],
"and",
[
"domain_rank",
">",
800
]
],
"order_by": [
"groups_count,desc"
],
"limit": 10
}
]'
{
"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,
"offset": null,
"items": [
{
"type": null,
"group": null,
"category": null,
"technology": null,
"groups_count": null,
"categories_count": null,
"technologies_count": null
}
]
}
]
}
]
}