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
- 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
}
]
}
]
}
]
}