تم التعامل معها باستخدام برمجة تطبيقات Ask

استفسر عن استخدام واجهة برمجة التطبيقات (API)

انت بحاجة الى تسجيل الدخول أو اشتراك لاستخدام واجهة برمجة التطبيقات BuiltWith.

مقدمة

تقوم واجهة برمجة تطبيقات BuiltWith Ask بتحويل أسئلة اللغة الطبيعية إلى عمليات بحث في قوائم BuiltWith، وتعيد مواقع الويب المطابقة التي لها نفس السمات الأساسية لواجهة برمجة تطبيقات Lists.

يُعيد البحث العادي دائمًا عينة. أضف COMMIT=true لإنشاء وتشغيل تقرير Ask كامل، يُعاد بالتسلسل مع التصفح عبر NEXTOFFSET.

طريقة الوصول العامة هي كما يلي:
https://api.builtwith.com/ask1/api.[xml|json|txt|csv|tsv]?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain

موجه وكيل الذكاء الاصطناعي
Reference https://api.builtwith.com/llms.txt
Add the BuiltWith Ask API to my app. Make a call to ask1/api.json for "Magento websites in Spain" and page committed results with NEXTOFFSET.
المصادقة

يجب عليك تقديم مفتاح API الخاص بك في كل عملية بحث باستخدام Ask API.

مفتاح API الخاص بك هو
00000000-0000-0000-0000-000000000000.

أمثلة

نموذج بحث JSON
https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain

يمكن أن تستخدم الاستعلامات أيضًا كلمات مفصولة بشرطة
https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento-websites-in-Spain

أنشئ تقرير "اسأل" كاملاً وقم بتشغيله
https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain&COMMIT=true

احصل على الصفحة التالية الملتزمة باستخدام قيمة NextOffset المُعادة
https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain&NEXTOFFSET=[NextOffset]

تضمين البيانات الوصفية
https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain&COMMIT=true&META=yes

مرجع
حدود
يمكن توفير معلمات GET التالية لعمليات البحث في واجهة برمجة تطبيقات Ask
اسمأمثلةمطلوب
KEY00000000-0000-0000-0000-000000000000
هذا هو مفتاح API الخاص بك.
نعم
QUERYMagento websites in Spain
استعلام باللغة الطبيعية. يمكن ترميز المسافات كـ %20 أو إدخالها كشرطات.
نعم
COMMITtrue
يقوم بإنشاء تقرير Ask API ويعيد الصفحة الأولى الكاملة من النتائج.
لا
NEXTOFFSETQWrd7gVNwFQCWb
يسترجع الصفحة التالية المُلتزمة. استخدم القيمة نفسها من NextOffset في الاستجابة السابقة. إذا كانت قيمة NextOffset هي END، فلن تكون هناك نتائج أخرى.
لا
METAyes
يعيد البيانات الوصفية مع النتائج، بما في ذلك الأسماء والألقاب وروابط التواصل الاجتماعي والعناوين ورسائل البريد الإلكتروني وأرقام الهواتف وترتيب حركة المرور حيثما كان ذلك متاحًا.
لا
الاستجابات
شكل: Ask1(Explanation,NextOffset,Results[R12])
اسممثالوصف
ExplanationMatched websites using Magento with a Spain location signal.شرح موجز لكيفية تفسير الاستعلام باللغة الطبيعية.
NextOffsetQWrd7gVNwFQCWbرابط تسلسل مشفر للصفحة التالية. عمليات البحث النموذجية تُرجع النهاية.
Results[R12]سيتم شرح كائنات النتيجة أدناه.المواقع الإلكترونية التي تتوافق مع استفسارك.
نتائج
توفر كائنات نتائج Ask API سمات Lists API، بدون LOS.
اسممثالوصف
Dexample.comموقع ويب يتطابق مع الاستعلام.
FD1495580400تم اكتشاف تقنية الثواني العصريّة لأول مرة.
LD1495580400تم اكتشاف تقنية الثواني العصريّة آخر مرة.
S323متوسط الإنفاق الشهري على التكنولوجيا بالدولار الأمريكي.
SKU1021منتجات فريدة متوفرة في قسم التجارة الإلكترونية بالموقع.
R5000تقدير إيرادات المبيعات لمواقع التجارة الإلكترونية.
F5000متابعون على مواقع التواصل الاجتماعي.
E100عدد الموظفين.
A657تصنيف الصفحة أعلى 100 مليون مرتبة حركة المرور.
Q565ترانكو في المرتبة الأولى في تصنيف حركة المرور.
M854مرتبة الرابط المهيبة رقم 1م.
U5460المرتبة الأولى في قائمة حركة المرور على مستوى العالم.
CountryESرمز الدولة ISO 3166-1 alpha-2.
METAكائن ميتا.يتم توفيره عند استخدام المعلمة META=yes.
ميتا
تتبع البيانات الوصفية كائن البيانات الوصفية لواجهة برمجة تطبيقات القوائم عند توفير META=yes.
أمثلة التعليمات البرمجية

أمثلة على كيفية إجراء طلبات Ask API:

var client = new HttpClient();
var url = "https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain";
var body = await client.GetStringAsync(url);
Console.WriteLine(body);
import requests
response = requests.get("https://api.builtwith.com/ask1/api.json", params={
    "KEY": "00000000-0000-0000-0000-000000000000",
    "QUERY": "Magento websites in Spain"
})
print(response.json())
const params = new URLSearchParams({
  KEY: '00000000-0000-0000-0000-000000000000',
  QUERY: 'Magento websites in Spain'
});
fetch('https://api.builtwith.com/ask1/api.json?' + params)
  .then(r => r.json())
  .then(console.log);
curl "https://api.builtwith.com/ask1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=Magento%20websites%20in%20Spain"
المجالات الخاصة

نحتفظ بقائمتين لاستخدامك عند البحث عن النطاقات: قوائم التجاهل وقوائم اللاحقات المبنية.

قائمة التجاهل
Tهذه قائمتنا الداخلية للنطاقات التي لا نفهرسها. إما أنها محظورة، أو تحتوي على تقنيات مضللة، أو نطاقات فرعية كثيرة جدًا بمحتوى من إنشاء المستخدمين.

BuiltWith قائمة اللواحق
وهذا يعتمد على قائمة اللواحق العامة لكنها تتضمن العديد من الإدخالات الإضافية للشركات التي لديها نطاقات فرعية يجب اعتبارها نطاقات المستوى الأعلى. توفر لنا هذه القائمة رؤية أفضل لمواقع الويب الداخلية، على سبيل المثال، فهي ترفع موقع northernbeaches.nsw.gov.au إلى المستوى الأعلى مقارنة بـ nsw.gov.au.

تجاهل المجالات (XML, JSON or TXT)
https://api.builtwith.com/ignoresv1/api.json
نطاقات اللواحق (XML, JSON or TXT)
https://api.builtwith.com/suffixv1/api.json
رموز الخطأ

لاحظ أن رسائل الخطأ بهذا التنسيق لا يمكن ضمانها، ويجب على تطبيقك أيضًا أن يأخذ في الاعتبار أكواد الاستجابة غير 200 كأخطاء. ستكون خاصية البحث فارغة (json) أو غير متوفرة (xml) إذا كان الخطأ متعلقًا بالخادم. عرض جميع رموز الأخطاء المحتملة ذات التكوين الجيد.

شروط الاستخدام

ملكنا الشروط القياسية تغطية استخدام كافة واجهات برمجة التطبيقات لدينا.

بشكل عام، يمكنك استخدام واجهة برمجة التطبيقات (API) لتحسين منتجك بطرق عديدة. القيد الوحيد هو عدم إمكانية إعادة بيع البيانات كما هي أو توفير وظائف مكررة لـbuiltwith.com والخدمات المرتبطة بها.