DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
النطاقات حسب مصطلحات HTML
يعثر على النطاقات التي يحتوي HTML فيها على search_terms معينة — مطابقة سلسلة خام حيث يطابق post_dataforseo_domains_tech_domains_by_technology_live تقنية مكتشفة. استخدمها لمقتطف تتبّع أو وسم تسويق بالعمولة أو بصمة قالب لا يسمّيها أي كاشف. يعيد total_count وitems_count وoffset وoffset_token وitems تحمل الملف التعريفي نفسه الخاص ببحث التقنية.
مرجع التسعير
- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 0.012 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: array (object | null)[]
- filtersالنوع: array (object | null)[] | null
مصفوفة معاملات تصفية النتائج
حقل اختياري
يمكنك إضافة عدة عوامل تصفية دفعةً واحدة (8 كحد أقصى)
يجب تعيين معامل منطقيandأوorبين الشروط
المعاملات المدعومة:<،<=،>،>=،=،<>،in،not_in،like،not_like
يمكنك استخدام المعامل%معlikeوnot_likeلمطابقة أي سلسلة من صفر أو أكثر من الأحرف
مثال:["domain","like","%seo%"][["country_iso_code","=","US"],
"and",
["domain_rank",">",100]][["domain_rank",">",100],
"and",
[["country_iso_code","=","US"],"or",["country_iso_code","=","CA"]]]لمزيد من المعلومات حول عوامل التصفية، راجع Domain Analytics Technologies API - Filters
كائن فارغ - keywordsالنوع: array string[] | null
- limitالنوع: integer | null
الحد الأقصى لعدد النطاقات المعادة
حقل اختياري
القيمة الافتراضية:100
الحد الأقصى للقيمة:10000 - modeالنوع: string | null
نمط البحث
حقل اختياري
أنواع نمط البحث الممكنة:strict_entry— البحث عن نتائج تطابق تمامًا الترتيب والفترات والفواصل في مصطلحات البحث المحددةentry— البحث عن نتائج تتجاهل الترتيب والفترات والفواصل في مصطلحات البحث المحددة
القيمة الافتراضية:entry - offsetالنوع: integer | null
الإزاحة في مصفوفة نتائج النطاقات المعادة
حقل اختياري
القيمة الافتراضية:0
إذا حددت القيمة10، فسيُحذف أول عشرة نطاقات من مصفوفة النتائج وستُقدَّم البيانات للنطاقات التالية؛
ملاحظة: الحد الأقصى للقيمة هو9999، ويجب ألا يتجاوز مجموعlimitوoffsetالقيمة10000؛
استخدمoffset_tokenإذا أردت إزاحة نتائج أكثر - offsetالنوع: string | null
_token رمز الإزاحة للطلبات اللاحقة
حقل اختياري
يُقدَّم في الحقل نفسه في استجابة كل طلب؛
استخدم هذا المعامل لتجنّب انتهاء المهلة عند محاولة الحصول على أكثر من 100,000 نتيجة في طلب واحد؛
بتحديد قيمةoffset_tokenالفريدة من مصفوفة الاستجابة، ستحصل على النتائج اللاحقة للمهمة الأولية؛
قيمoffset_tokenفريدة لكل مهمة لاحقة
ملاحظة: إذا حُدِّدoffset_tokenفي الطلب، فيجب أن تكون جميع المعاملات الأخرى مطابقة للطلب السابق
تعرّف على المزيد حول هذا المعامل في مركز المساعدة - orderالنوع: array string[] | null
_by قواعد ترتيب النتائج
حقل اختياري
الحقول المتاحة:domain_rank،domain،last_visited،country_iso_code،language_code،content_language_code
أنواع الترتيب الممكنة:asc— ستُرتَّب النتائج بترتيب تصاعديdesc— ستُرتَّب النتائج بترتيب تنازلي
يجب استخدام فاصلة لتعيين نوع الترتيب
مثال:["last_visited,desc"]
القاعدة الافتراضية:["domain_rank,desc"]
لاحظ أنه لا يمكنك تعيين أكثر من ثلاث قواعد ترتيب في طلب واحد
يجب استخدام فاصلة لفصل عدة قواعد ترتيب
مثال:["last_visited,desc","domain_rank,desc"] - searchالنوع: array string[]
_terms مصطلحات البحث المستهدفة
حقل مطلوب
حدّد عناصر HTML المستهدفة أو الوسوم أو السمات أو محتواها أو كل ما سبق
إذا حددت أكثر من مصطلح بحث، فلن تتلقى إلا النطاقات التي تحتوي على جميع المصطلحات المحددة في كود HTML لصفحتها الرئيسية
الحد الأقصى لعدد مصطلحات البحث التي يمكنك تحديدها: 10
مثال:["data-attrid"]
- النوع: object | null · Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveResponseInfo200
- النوع: number | null التنسيق: doublecost
إجمالي تكلفة المهام، بالدولار الأمريكي
- النوع: integer | nullstatus
_code رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا
- النوع: string | nullstatus
_message رسالة معلوماتية عامة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا
- النوع: array (object | null)[] | nulltasks
مصفوفة المهام
- النوع: object | null · Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveTaskInfo
- 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
- contentالنوع: string | null
_language _code لغة المحتوى
رمز اللغة المكتوب بها المحتوى على النطاق الهدف - countryالنوع: string | null
_iso _code رمز ISO للنطاق
رمز ISO للبلد الذي حُدِّد أن النطاق الهدف ينتمي إليه - descriptionالنوع: string | null
الوصف التعريفي للنطاق
- domainالنوع: string | null
اسم النطاق المحدد
- domainالنوع: integer | null
_rank - emailsالنوع: array (string | null)[] | null
عناوين البريد الإلكتروني للهدف
عناوين البريد الإلكتروني المشار إليها على موقع الهدف - languageالنوع: string | null
_code لغة النطاق
رمز اللغة التي حُدِّد أن النطاق الهدف مرتبط بها - lastالنوع: string | null
_visited أحدث تاريخ زار فيه الزاحف النطاق
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2022-10-10 12:57:46 +00:00 - metaالنوع: array (string | null)[] | null
_keywords الكلمات المفتاحية التعريفية للنطاق
- phoneالنوع: array (string | null)[] | null
_numbers أرقام هاتف الهدف
أرقام الهاتف للتواصل المشار إليها على موقع الهدف - socialالنوع: array (string | null)[] | null
_graph _urls روابط ومعرّفات وسائل التواصل الاجتماعي
عناوين URL لوسائل التواصل الاجتماعي المكتشفة في الرسوم الاجتماعية لموقع الهدف - technologiesالنوع: object | null · Response36Afe1097B20_TechnologiesInfo
- addالنوع: object | null
_ons - propertyالنوع: array (string | null)[] | null
Name
- analyticsالنوع: object | null
- propertyالنوع: array (string | null)[] | null
Name
- bookingالنوع: object | null
- propertyالنوع: array (string | null)[] | null
Name
- businessالنوع: object | null
_tools - propertyالنوع: array (string | null)[] | null
Name
- communicationالنوع: object | null
- propertyالنوع: array (string | null)[] | null
Name
- contentالنوع: object | null
- propertyالنوع: array (string | null)[] | null
Name
- locationالنوع: object | null
- propertyالنوع: array (string | null)[] | null
Name
- marketingالنوع: object | null
- propertyالنوع: array (string | null)[] | null
Name
- mediaالنوع: object | null
- propertyالنوع: array (string | null)[] | null
Name
- otherالنوع: object | null
- propertyالنوع: array (string | null)[] | null
Name
- privacyالنوع: object | null
- propertyالنوع: array (string | null)[] | null
Name
- salesالنوع: object | null
- propertyالنوع: array (string | null)[] | null
Name
- securityالنوع: object | null
- propertyالنوع: array (string | null)[] | null
Name
- serversالنوع: object | null
- propertyالنوع: array (string | null)[] | null
Name
- userالنوع: object | null
_generated _content - propertyالنوع: array (string | null)[] | null
Name
- utilitiesالنوع: object | null
- propertyالنوع: array (string | null)[] | null
Name
- webالنوع: object | null
_development - propertyالنوع: array (string | null)[] | null
Name
- titleالنوع: string | null
العنوان التعريفي للنطاق
- typeالنوع: string | null
نوع العنصر
- itemsالنوع: integer | null التنسيق: int64
_count عدد العناصر في مصفوفة النتائج
- offsetالنوع: integer | null
قيمة الإزاحة المحددة
- offsetالنوع: string | null
_token رمز للطلبات اللاحقة
بتحديدoffset_tokenالفريد عند إعداد مهمة جديدة، ستحصل على النتائج اللاحقة للمهمة الأولية
قيمoffset_tokenفريدة لكل مهمة لاحقة - 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/domains_by_html_terms/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"search_terms": [
"data-attrid"
],
"order_by": [
"last_visited,desc"
],
"limit": 10,
"offset": 0
}
]'
{
"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,
"offset_token": null,
"items": [
{
"type": null,
"domain": null,
"title": null,
"description": null,
"meta_keywords": [
"[Max Depth Exceeded]"
],
"domain_rank": null,
"last_visited": null,
"country_iso_code": null,
"language_code": null,
"content_language_code": null,
"phone_numbers": [
"[Max Depth Exceeded]"
],
"emails": [
"[Max Depth Exceeded]"
],
"social_graph_urls": [
"[Max Depth Exceeded]"
],
"technologies": "[Max Depth Exceeded]"
}
]
}
]
}
]
}