وثائق API Hop
مرجع نقاط نهاية SimilarwebAPI
>-
جميع المسارات أدناه نسبية إلى أصل API الخاص بك. يتطلب كل طلب Authorization: Bearer YOUR_API_KEY، ويستخدم GET دون نص طلب. راجع المصادقة والفوترة والأخطاء.
قواعد الاستعلام
يتطلب حقلا الموقع المفرد key وKey نطاق ASCII واحدًا مثل amazon.com، بطول لا يتجاوز 253 حرفًا ودون مسافات محيطة. لا ترسل رابط URL أو عنوان IP أو قائمة نطاقات أو بيانات اعتماد API في هذين الحقلين. استخدم punycode لأسماء النطاقات الدولية.
أسماء الاستعلامات حساسة لحالة الأحرف. تُرفض الحقول غير المعروفة والمكررة ومحارف CR/LF/NUL والقيم غير الصالحة. القيم المنطقية هي حرفيًا true أو false؛ ولا يمكن استخدام الصفر بدلًا من false. يتراوح حجم النص بين 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة. رمّز المسافات ومصفوفات JSON والفواصل باستخدام مُرمّز الاستعلامات في عميل HTTP.
يجب أن يُرسَل from وto معًا، وأن يكونا تاريخين تقويميين حقيقيين بتنسيق YYYY-MM-DD أو YYYY|MM|DD، وأن يحققا from <= to. ويتبع زوج تواريخ المقارنة القاعدة نفسها. ترث الحقول الاختيارية القيم الافتراضية لنقطة النهاية؛ وتسرد الجداول الحقول المسموحة ولا تشترط إرسالها جميعًا.
في نقاط النهاية التي تقبل التواريخ، تكون الأولوية لنطاق from/to الصريح والكامل والصالح. وفي نقاط النهاية التي تقبل latest، يجب أن تجتاز القيمة المقدّمة التحقق المعتاد من التنسيق والقواعد الخاصة بنقطة النهاية، لكن تُتجاهل عند اختيار النطاق ولا تُرسل إلى Similarweb؛ ولا تُضاف قيمة افتراضية لـ latest. دون نطاق صريح، لا يتغير سلوك latest والقيم الافتراضية والنوافذ الزمنية المعتاد. تظل قيود السجل سارية، وتظل نقاط النهاية التي لا تقبل latest ترفضه.
دون نطاق from/to صريح: تكون القيمة الافتراضية للمسارات المعتمدة على نافذة زمنية عادةً 28 يومًا تنتهي قبل ثلاثة أيام بتوقيت UTC، وتقبل من latest=1d إلى 366d. لمسارات الأشهر الثابتة القيم الافتراضية المبينة أدناه. وتقبل التفاعلات والزيارات والترتيبات والقنوات أيضًا latest=1m|2m|3m|6m للأشهر التقويمية السابقة المكتملة بتوقيت UTC؛ وتتطلب هذه المحددات isWindow=false، وتستخدم افتراضيًا timeGranularity=Monthly. للسجل قواعد أضيق موثقة لنقاط نهايته الأربع.
تُدعم البيانات العالمية فقط (country=999). معرّفات المواقع نطاقات مثل example.com، باستثناء نقطة نهاية ترتيب الكلمات المفتاحية حيث يكون keys كلمة بحث. قد يختلف توفر بيانات المزوّد والمرشحات وأنواع المطابقة. تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين.
تحافظ الاستجابات الناجحة على JSON الأصلي بدلًا من اعتماد مخطط استجابة موحد. تستخدم جداول الإحالات الواردة والصادرة Records؛ وقد تستخدم المقاييس التاريخية Data متداخلة. لا تعني الأسماء والوحدات الموضحة أدناه وجود كل حقل اختياري لدى المزوّد دائمًا.
نقاط النهاية
اقتراحات الكلمات المفتاحية
GET https://api.apihop.ai/v1/similarweb/keywords/suggestions
القيم الافتراضية: country 999 وlatest 28d وrowsPerPage 100 وtype Broad وwebsource Total، وwindowVolume بترتيب تنازلي. يبدأ page الاختياري من 1. يستخدم rangeFilter الصياغة الأصلية، مثل volume,100,10000|difficulty,0,40. يعتمد توفر أنواع المطابقة والمرشحات على مصدر البيانات. تُدعم البيانات العالمية فقط (country=999).
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
keyword | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
latest | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
sort | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
asc | لا | سلسلة لقيمة منطقية: true أوfalse |
page | لا | سلسلة لعدد صحيح؛ 1-1000 |
rowsPerPage | لا | سلسلة لعدد صحيح؛ 1-1000 |
type | لا | سلسلة نصية؛ قيم محددة: Broad, Phrase, Exact, Related |
websource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
rangeFilter | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
الروابط الخلفية
GET https://api.apihop.ai/v1/similarweb/websites/backlinks
القيم الافتراضية: Page 1 وPageSize 100 وStatus All وFollowType All، وDomainScore بترتيب تنازلي. يبدأ Key بحرف كبير؛ لا تستخدم key أو keys.
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
Key | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
Page | لا | سلسلة لعدد صحيح؛ 1-1000 |
PageSize | لا | سلسلة لعدد صحيح؛ 1-1000 |
Status | لا | سلسلة نصية؛ قيم محددة: All, Active, New, Lost |
FollowType | لا | سلسلة نصية؛ قيم محددة: All, DoFollowOnly, NoFollowOnly, DoFollow, NoFollow |
DomainScoreFrom | لا | سلسلة لعدد صحيح؛ 0-100 |
DomainScoreTo | لا | سلسلة لعدد صحيح؛ 0-100 |
sort | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
asc | لا | سلسلة لقيمة منطقية: true أوfalse |
الكلمات المفتاحية للموقع
GET https://api.apihop.ai/v1/similarweb/websites/keywords
القيم الافتراضية: page 1 وpageSize 100 وsourceType all، وكلا علمَي العلامة التجارية false. يكون pageFilterJson سلسلة واحدة لمصفوفة JSON مرمّزة للرابط؛ وعند حذفه يستهدف keys كنطاق. دون نطاق from/to صريح: يحدد latest=1m وضع النظرة العامة لشهر واحد مع pageSize 5 وisWindow=false ما لم تُقدَّم قيم صريحة. استخدم sourceType=organic أو paid مع IncludeNoneBranded=true وIncludeBranded=false لعرض الكلمات غير المرتبطة بالعلامة التجارية.
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
keys | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
includeSubDomains | لا | سلسلة لقيمة منطقية: true أوfalse |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
webSource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
timeGranularity | لا | سلسلة نصية؛ قيم محددة: Daily, Monthly |
latest | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
sort | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
asc | لا | سلسلة لقيمة منطقية: true أوfalse |
iso | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
isDaily | لا | سلسلة لقيمة منطقية: true أوfalse |
IncludeBranded | لا | سلسلة لقيمة منطقية: true أوfalse |
IncludeNoneBranded | لا | سلسلة لقيمة منطقية: true أوfalse |
page | لا | سلسلة لعدد صحيح؛ 1-1000 |
pageSize | لا | سلسلة لعدد صحيح؛ 1-1000 |
sourceType | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
pageFilterJson | لا | سلسلة نصية تحتوي على مصفوفة JSON |
المواقع المرتبة لكلمة مفتاحية
GET https://api.apihop.ai/v1/similarweb/keywords/websites
يمثل keys كلمة مفتاحية وليس نطاق موقع. تشمل القيم الافتراضية selectedPageTab=Organic وsourceType=organic وDevice=Total وgraphDuration=28d. يستخدم page الاختياري ترقيمًا يبدأ من 1، ويستخدم pageSize الاختياري عددًا صحيحًا موجبًا.
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
keys | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
includeSubDomains | لا | سلسلة لقيمة منطقية: true أوfalse |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
webSource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
timeGranularity | لا | سلسلة نصية؛ قيم محددة: Daily, Monthly |
latest | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
sort | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
asc | لا | سلسلة لقيمة منطقية: true أوfalse |
iso | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
isDaily | لا | سلسلة لقيمة منطقية: true أوfalse |
tab | لا | سلسلة لعدد صحيح غير سالب |
mtd | لا | سلسلة لقيمة منطقية: true أوfalse |
selectedPageTab | لا | سلسلة نصية؛ قيم محددة: Organic, Paid |
graphDuration | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
graphType | لا | سلسلة لعدد صحيح؛ 1-1000 |
isDurationChanged | لا | سلسلة لقيمة منطقية: true أوfalse |
ignoreFilterConsistency | لا | سلسلة لقيمة منطقية: true أوfalse |
Device | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
sourceType | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
page | لا | سلسلة لعدد صحيح؛ 1-1000 |
pageSize | لا | سلسلة لعدد صحيح؛ 1-1000 |
مصادر الزيارات
GET https://api.apihop.ai/v1/similarweb/websites/traffic-sources
القيم الافتراضية: sourceType=Referral وpage=1 وorderBy=Share desc وtimeGranularity=Daily. هذا الجدول منفصل عن نقطة نهاية incoming-referrals.
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
keys | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
includeSubDomains | لا | سلسلة لقيمة منطقية: true أوfalse |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
webSource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
timeGranularity | لا | سلسلة نصية؛ قيم محددة: Daily, Monthly |
latest | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
sourceType | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
ignoreFilterConsistency | لا | سلسلة لقيمة منطقية: true أوfalse |
page | لا | سلسلة لعدد صحيح؛ 1-1000 |
orderBy | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
الزيارات الصادرة
GET https://api.apihop.ai/v1/similarweb/websites/outgoing-traffic
الحقلان from وto مطلوبان. يُستخدم key المفرد فقط. القيم الافتراضية: country=999 وisWWW=false وisWindow=false وwebSource=Total وpage=1 وorderby=Share desc وorderBy=Share desc وsort=Share وasc=false. الحقلان orderby وorderBy منفصلان ويُمرَّران بصورة مستقلة؛ حافظ على اتساقهما. لا تتوفر latest أوpageSize أوrowsPerPage أوincludeSubDomains أوtimeGranularity. الصفوف في Records؛ وTotalCount هو الإجمالي لدى المزوّد وليس طول الصفحة الحالية. تُدعم البيانات العالمية فقط (country=999).
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
key | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | نعم | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | نعم | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
isWWW | لا | سلسلة لقيمة منطقية: true أوfalse |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
webSource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
orderby | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
orderBy | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
sort | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
asc | لا | سلسلة لقيمة منطقية: true أوfalse |
page | لا | سلسلة لعدد صحيح؛ 1-1000 |
الإحالات الواردة
GET https://api.apihop.ai/v1/similarweb/websites/incoming-referrals
يُستخدم key المفرد فقط. القيم الافتراضية: country=999 وlatest=28d وisWWW=false وisWindow=true وisDaily=false وwebSource=Total وselectedTab=incomingTraffic وorderBy=TotalShare desc وignoreFilterConsistency=false وpage=1. لا تتوفر keys أوpageSize أوrowsPerPage أوincludeSubDomains أوtimeGranularity. الصفوف في Records؛ وقد تشمل الحقول الأصلية SiteOrigins وTotalShare. تُدعم البيانات العالمية فقط (country=999).
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
key | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
isWWW | لا | سلسلة لقيمة منطقية: true أوfalse |
iso | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
isDaily | لا | سلسلة لقيمة منطقية: true أوfalse |
latest | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
webSource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
selectedTab | لا | سلسلة نصية؛ قيم محددة: incomingTraffic |
orderBy | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
ignoreFilterConsistency | لا | سلسلة لقيمة منطقية: true أوfalse |
page | لا | سلسلة لعدد صحيح؛ 1-1000 |
حصة الكلمات المرتبطة بالعلامة التجارية
GET https://api.apihop.ai/v1/similarweb/websites/branded-keywords
القيمة الافتراضية هي الشهر السابق المكتمل بتوقيت UTC. تكون duration ثابتة عند 1m.
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
keys | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
includeSubDomains | لا | سلسلة لقيمة منطقية: true أوfalse |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
webSource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
timeGranularity | لا | سلسلة نصية؛ قيم محددة: Daily, Monthly |
latest | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
duration | لا | سلسلة نصية؛ قيم محددة: 1m |
التوزيع الجغرافي للزيارات
GET https://api.apihop.ai/v1/similarweb/websites/geography
القيمة الافتراضية هي الأشهر الثلاثة السابقة المكتملة بتوقيت UTC، مع pageSize=5 وorderBy=TotalShare desc.
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
keys | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
includeSubDomains | لا | سلسلة لقيمة منطقية: true أوfalse |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
webSource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
timeGranularity | لا | سلسلة نصية؛ قيم محددة: Daily, Monthly |
latest | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
pageSize | لا | سلسلة لعدد صحيح؛ 1-1000 |
orderBy | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
توزيع الأجهزة
GET https://api.apihop.ai/v1/similarweb/websites/devices
القيمة الافتراضية هي الأشهر الثلاثة السابقة المكتملة بتوقيت UTC وShouldGetVerifiedData=false.
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
keys | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
includeSubDomains | لا | سلسلة لقيمة منطقية: true أوfalse |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
webSource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
timeGranularity | لا | سلسلة نصية؛ قيم محددة: Daily, Monthly |
latest | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
ShouldGetVerifiedData | لا | سلسلة لقيمة منطقية: true أوfalse |
أداء البحث
GET https://api.apihop.ai/v1/similarweb/websites/search-performance
القيمة الافتراضية هي الشهر السابق المكتمل بتوقيت UTC، مع pageSize=5 وduration=1m وSourceType=Organic. استخدم SourceType=Paid للكلمات المفتاحية المدفوعة؛ ولا تستبدله بـ sourceType.
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
keys | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
includeSubDomains | لا | سلسلة لقيمة منطقية: true أوfalse |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
webSource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
timeGranularity | لا | سلسلة نصية؛ قيم محددة: Daily, Monthly |
latest | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
pageSize | لا | سلسلة لعدد صحيح؛ 1-1000 |
duration | لا | سلسلة نصية؛ قيم محددة: 1m |
SourceType | لا | سلسلة نصية؛ قيم محددة: Organic, Paid |
الزيارات من الشبكات الاجتماعية
GET https://api.apihop.ai/v1/similarweb/websites/social-traffic
القيمة الافتراضية هي الأشهر الثلاثة السابقة المكتملة بتوقيت UTC. لا يُقبل webSource.
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
keys | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
includeSubDomains | لا | سلسلة لقيمة منطقية: true أوfalse |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
timeGranularity | لا | سلسلة نصية؛ قيم محددة: Daily, Monthly |
latest | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
نظرة عامة على التفاعل
GET https://api.apihop.ai/v1/similarweb/websites/engagement
تشمل القيم الافتراضية ShouldGetVerifiedData=false وincludeLeaders=true وunBounced=false. قد تحتوي صفوف Data الأصلية على AvgMonthVisits وBounceRate وPagesPerVisit وAvgVisitDuration.
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
keys | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
includeSubDomains | لا | سلسلة لقيمة منطقية: true أوfalse |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
webSource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
timeGranularity | لا | سلسلة نصية؛ قيم محددة: Daily, Monthly |
latest | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
ShouldGetVerifiedData | لا | سلسلة لقيمة منطقية: true أوfalse |
includeLeaders | لا | سلسلة لقيمة منطقية: true أوfalse |
unBounced | لا | سلسلة لقيمة منطقية: true أوfalse |
beta | لا | سلسلة لقيمة منطقية: true أوfalse |
إجمالي الزيارات
GET https://api.apihop.ai/v1/similarweb/websites/visits
يجب تقديم compareFrom وcompareTo معًا كتاريخين صالحين بالترتيب الصحيح. تكون timeGranularity هي Monthly. قد تشمل الحقول الأصلية TotalVisits وChange وShareOfVisits؛ وإجمالي النافذة المتحركة ليس بالضرورة إجمالي شهر تقويمي مكتمل.
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
keys | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
includeSubDomains | لا | سلسلة لقيمة منطقية: true أوfalse |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
webSource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
timeGranularity | لا | سلسلة نصية؛ قيم محددة: Monthly |
latest | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
compareFrom | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
compareTo | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
ShouldGetVerifiedData | لا | سلسلة لقيمة منطقية: true أوfalse |
جدول الزيارات
GET https://api.apihop.ai/v1/similarweb/websites/visits/table
يجب تقديم compareFrom وcompareTo معًا كتاريخين صالحين بالترتيب الصحيح. تكون timeGranularity هي Monthly؛ وتوجد الصفوف في Data مع Domain وTotalVisits. يمكن أن تكون TotalCount مساوية لـ 0 حتى عندما تحتوي Data على صفوف؛ افحص المصفوفة نفسها لتحديد وجود نتائج.
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
keys | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
includeSubDomains | لا | سلسلة لقيمة منطقية: true أوfalse |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
webSource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
timeGranularity | لا | سلسلة نصية؛ قيم محددة: Monthly |
latest | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
compareFrom | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
compareTo | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
ShouldGetVerifiedData | لا | سلسلة لقيمة منطقية: true أوfalse |
اتجاه الزيارات
GET https://api.apihop.ai/v1/similarweb/websites/visits/trend
القيمة الافتراضية هي نافذة يومية متحركة مدتها 28 يومًا. يقبل timeGranularity القيم Daily أوWeekly أوMonthly.
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
keys | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
includeSubDomains | لا | سلسلة لقيمة منطقية: true أوfalse |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
webSource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
timeGranularity | لا | سلسلة نصية؛ قيم محددة: Daily, Weekly, Monthly |
latest | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
ShouldGetVerifiedData | لا | سلسلة لقيمة منطقية: true أوfalse |
ترتيبات الموقع
GET https://api.apihop.ai/v1/similarweb/websites/ranks
تكون timeGranularity هي Monthly. تستخدم الاستجابة الأصلية كائنات منفصلة هي GlobalRank وCountryRank وCategoryRank.
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
keys | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
includeSubDomains | لا | سلسلة لقيمة منطقية: true أوfalse |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
webSource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
timeGranularity | لا | سلسلة نصية؛ قيم محددة: Monthly |
latest | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
الترتيب حسب البلد
GET https://api.apihop.ai/v1/similarweb/websites/ranks/country
تكون timeGranularity هي Monthly. هذا جدول ترتيب البلد تحديدًا، وليس استجابة الترتيبات المجمعة. توجد الصفوف في Data مع Domain وRank. يمكن أن تكون TotalCount مساوية لـ 0 حتى عند وجود صفوف؛ افحص Data مباشرةً.
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
keys | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
includeSubDomains | لا | سلسلة لقيمة منطقية: true أوfalse |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
webSource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
timeGranularity | لا | سلسلة نصية؛ قيم محددة: Monthly |
latest | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
الترتيب العالمي
GET https://api.apihop.ai/v1/similarweb/websites/ranks/global
تكون timeGranularity هي Monthly. تعيد نقطة النهاية جدول الترتيب العالمي المنفصل. توجد الصفوف في Data مع Domain وRank. يمكن أن تكون TotalCount مساوية لـ 0 حتى عند وجود صفوف؛ افحص Data مباشرةً.
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
keys | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
includeSubDomains | لا | سلسلة لقيمة منطقية: true أوfalse |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
webSource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
timeGranularity | لا | سلسلة نصية؛ قيم محددة: Monthly |
latest | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
الترتيب حسب الفئة
GET https://api.apihop.ai/v1/similarweb/websites/ranks/category
تكون timeGranularity هي Monthly. تعيد نقطة النهاية جدول ترتيب القطاع أو الفئة المنفصل. توجد الصفوف في Data مع Domain وRank. يمكن أن تكون TotalCount مساوية لـ 0 حتى عند وجود صفوف؛ افحص Data مباشرةً.
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
keys | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
includeSubDomains | لا | سلسلة لقيمة منطقية: true أوfalse |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
webSource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
timeGranularity | لا | سلسلة نصية؛ قيم محددة: Monthly |
latest | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
قنوات الزيارات
GET https://api.apihop.ai/v1/similarweb/websites/channels
القيمة الافتراضية هي نافذة يومية متحركة مدتها 28 يومًا. مع webSource=Total، توجد قيم القنوات تحت Data.Total[domain] وليس مباشرةً تحت Data[domain]. تُحفظ أسماء القنوات، مثل Search - Organic وDirect. تمثل القيم أعداد الزيارات؛ ولا تحسب الحصص إلا عندما يكون مجموعها موجبًا.
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
keys | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
includeSubDomains | لا | سلسلة لقيمة منطقية: true أوfalse |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
webSource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
timeGranularity | لا | سلسلة نصية؛ قيم محددة: Daily, Monthly |
latest | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
المواقع المشابهة
GET https://api.apihop.ai/v1/similarweb/websites/similar-sites
القيمة الافتراضية هي الأشهر الثلاثة السابقة المكتملة بتوقيت UTC. يجب أن تكون isWindow هي false، وتكون timeGranularity هي Monthly، وorderBy ثابتة عند Affinity desc. لا تتوفر latest أوwebSource.
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
keys | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
includeSubDomains | لا | سلسلة لقيمة منطقية: true أوfalse |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
timeGranularity | لا | سلسلة نصية؛ قيم محددة: Monthly |
orderBy | لا | سلسلة نصية؛ قيم محددة: Affinity desc |
اقتراحات المواقع المشابهة
GET https://api.apihop.ai/v1/similarweb/websites/similar-sites/suggestions
يُستخدم key المفرد؛ والقيمة الافتراضية لـ limit هي 20 ويجب أن تقع ضمن 1-20. القيمة الافتراضية لـ country هي 999 ولـ webSource هي Total. الاستجابة الأصلية المرصودة مصفوفة غير مغلفة من المرشحين تحتوي على Domain وDomainWithoutSub وRank العددي وFavicon؛ فلا تتوقع غلاف Data. المصفوفة الفارغة لا تحتوي على اقتراحات. تُدعم البيانات العالمية فقط (country=999).
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
key | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
limit | لا | سلسلة لعدد صحيح؛ 1-20 |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
webSource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
سجل الزيارات الشهرية
GET https://api.apihop.ai/v1/similarweb/websites/history/visits
القيمة الافتراضية هي الأشهر الستة السابقة المكتملة بتوقيت UTC. تُدعم فقط country=999 وisWindow=false وtimeGranularity=Monthly. يقبل latest من 1m إلى 6m؛ ويجب أن تغطي التواريخ الصريحة أشهرًا مكتملة ضمن هذه النافذة المتحركة ذات الأشهر الستة. قد تظهر السلاسل الأصلية تحت Data.<domain>.<source> مع نقاط Key/Value؛ وتُحفظ أسماء المصادر، بما فيها MobileWeb أوMobile Web. تمثل القيم الزيارات المقدّرة.
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
keys | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
includeSubDomains | لا | سلسلة لقيمة منطقية: true أوfalse |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
webSource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
timeGranularity | لا | سلسلة نصية؛ قيم محددة: Monthly |
latest | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
سجل معدل الارتداد الشهري
GET https://api.apihop.ai/v1/similarweb/websites/history/bounce-rate
القيمة الافتراضية هي الأشهر الستة السابقة المكتملة بتوقيت UTC. تُدعم فقط country=999 وisWindow=false وtimeGranularity=Monthly. يقبل latest من 1m إلى 6m؛ ويجب أن تغطي التواريخ الصريحة أشهرًا مكتملة ضمن هذه النافذة المتحركة ذات الأشهر الستة. قد تظهر السلاسل الأصلية تحت Data.<domain>.<source> مع نقاط Key/Value؛ وتُحفظ أسماء المصادر، بما فيها MobileWeb أوMobile Web. تمثل القيم نسب معدل الارتداد.
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
keys | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
includeSubDomains | لا | سلسلة لقيمة منطقية: true أوfalse |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
webSource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
timeGranularity | لا | سلسلة نصية؛ قيم محددة: Monthly |
latest | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
سجل مدة الزيارة الشهرية
GET https://api.apihop.ai/v1/similarweb/websites/history/visit-duration
القيمة الافتراضية هي الأشهر الستة السابقة المكتملة بتوقيت UTC. تُدعم فقط country=999 وisWindow=false وtimeGranularity=Monthly. يقبل latest من 1m إلى 6m؛ ويجب أن تغطي التواريخ الصريحة أشهرًا مكتملة ضمن هذه النافذة المتحركة ذات الأشهر الستة. قد تظهر السلاسل الأصلية تحت Data.<domain>.<source> مع نقاط Key/Value؛ وتُحفظ أسماء المصادر، بما فيها MobileWeb أوMobile Web. تمثل القيم الثواني لكل زيارة.
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
keys | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
includeSubDomains | لا | سلسلة لقيمة منطقية: true أوfalse |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
webSource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
timeGranularity | لا | سلسلة نصية؛ قيم محددة: Monthly |
latest | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
سجل الصفحات لكل زيارة شهريًا
GET https://api.apihop.ai/v1/similarweb/websites/history/pages-per-visit
القيمة الافتراضية هي الأشهر الستة السابقة المكتملة بتوقيت UTC. تُدعم فقط country=999 وisWindow=false وtimeGranularity=Monthly. يقبل latest من 1m إلى 6m؛ ويجب أن تغطي التواريخ الصريحة أشهرًا مكتملة ضمن هذه النافذة المتحركة ذات الأشهر الستة. قد تظهر السلاسل الأصلية تحت Data.<domain>.<source> مع نقاط Key/Value؛ وتُحفظ أسماء المصادر، بما فيها MobileWeb أوMobile Web. تمثل القيم الصفحات لكل زيارة.
| حقل الاستعلام | مطلوب | النوع والقيود |
|---|---|---|
keys | نعم | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |
country | لا | سلسلة لعدد صحيح غير سالب؛ تُدعم البيانات العالمية فقط (country=999). تُحوَّل قيم البلدان الأخرى الصالحة إلى 999 قبل إرسال الطلب إلى المزوّد، وتعيد بيانات عالمية لا بيانات خاصة ببلد معين. |
from | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
to | لا | سلسلة نصية؛ تاريخ صالح بأحد التنسيقات أعلاه |
includeSubDomains | لا | سلسلة لقيمة منطقية: true أوfalse |
isWindow | لا | سلسلة لقيمة منطقية: true أوfalse |
webSource | لا | سلسلة نصية؛ قيم محددة: Total, Desktop, MobileWeb |
timeGranularity | لا | سلسلة نصية؛ قيم محددة: Monthly |
latest | لا | سلسلة نصية؛ 1-2048 بايت بترميز UTF-8 بعد إزالة المسافات المحيطة |