برمجة تطبيقات البحث المتجهي BuildWith

مقدمة

ابحث عن التقنيات والفئات باستخدام الاستعلام النصي وتقنية تشابه المتجهات. اعثر على التقنيات والفئات ذات الصلة من خلال وصف ما تبحث عنه.

طريقة الوصول العامة هي كما يلي -
https://api.builtwith.com/vector/v1/api.[xml|json|csv]?KEY=00000000-0000-0000-0000-000000000000&QUERY=<search term>

تستخدم واجهة برمجة تطبيقات البحث المتجهي رصيدًا واحدًا من رصيد واجهة برمجة التطبيقات لكل عملية بحث، بغض النظر عن حجم النتائج.

🤖 موجه وكيل الذكاء الاصطناعي

Reference https://api.builtwith.com/llms.txt and
https://raw.githubusercontent.com/builtwith/builtwith-ai-sdk/refs/heads/main/README.md
Add builtwith AI api to my app as a client. Make a call to the vector search API to find technologies related to the query hotel booking

مثال

توضح الأمثلة التالية كيفية استدعاء واجهة برمجة تطبيقات البحث المتجهي.

JSON

https://api.builtwith.com/vector/v1/api.json?KEY=00000000-0000-0000-0000-000000000000&QUERY=react+framework

XML

https://api.builtwith.com/vector/v1/api.xml?KEY=00000000-0000-0000-0000-000000000000&QUERY=google+analytics

CSV

https://api.builtwith.com/vector/v1/api.csv?KEY=00000000-0000-0000-0000-000000000000&QUERY=ecommerce+platform&LIMIT=25

مرجع

حدود

يمكن توفير معلمات GET التالية لعمليات البحث

اسم	أمثلة	مطلوب
`KEY`	`00000000-0000-0000-0000-000000000000` هذا هو مفتاحك، استخدمه للبحث.	نعم
`QUERY`	`react framework` مصطلح البحث للعثور على التقنيات والفئات المطابقة.	نعم
`TYPE`	`json` / `xml` / `csv` تنسيق الاستجابة. يتم تحديده كملحق الملف في عنوان URL.	نعم
`LIMIT`	`10` عدد النتائج المطلوب إرجاعها. القيمة الافتراضية هي 10، والحد الأقصى هو 100.	لا

الاستجابات

يحتوي الرد ذو المستوى الأعلى على Query سلسلة تعكس مصطلح البحث، أ Results مصفوفة، و Errors مصفوفة.

جميع النتائج

تظهر هذه الحقول في كل نتيجة بغض النظر عن نوعها.

اسم	مثال	وصف
`Type`	`tech` / `category`	سواء كان ذلك تطابقًا تقنيًا أو فئويًا.
`Name`	`Google Analytics`	اسم التقنية أو الفئة المطابقة.
`Tag`	`analytics`	علامة تصنيف فئة التكنولوجيا من المستوى الأعلى.
`Score`	`0.9812`	تتراوح درجة التشابه بين 0 و1 حتى أربعة منازل عشرية. تشير القيم الأعلى إلى تطابق أفضل.

نتائج التكنولوجيا Type: tech

تظهر هذه الحقول الإضافية عندما تكون النتيجة تقنية.

اسم	مثال	وصف
`Icon`	`https://favicon.builtwith.com/google.com`	رابط أيقونة الموقع (Favicon) لموقع الشركة التقنية.
`Description`	`Web analytics service offered by Google`	وصف موجز للتكنولوجيا.
`Categories`	`["Web Analytics", "Tag Management"]`	مجموعة من أسماء الفئات الفرعية التي تنتمي إليها التكنولوجيا.
`IsPremium`	`true` / `false`	سواء كانت هذه تقنية مميزة / مدفوعة.
`Link`	`https://analytics.google.com`	رابط الموقع الإلكتروني الرسمي لهذه التقنية.
`TrendsLink`	`https://trends.builtwith.com/analytics/Google-Analytics`	رابط إلى صفحة اتجاهات BuiltWith الخاصة بهذه التقنية.

نتائج الفئات Type: category

تظهر هذه الحقول الإضافية عندما تكون النتيجة عبارة عن فئة.

اسم	مثال	وصف
`TrendsLink`	`//trends.builtwith.com/analytics/web-analytics`	رابط إلى صفحة اتجاهات BuiltWith لهذه الفئة.

أمثلة التعليمات البرمجية

curl

curl "https://api.builtwith.com/vector/v1/api.json?KEY=YOUR_KEY&QUERY=react+framework"

المجالات الخاصة

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

قائمة التجاهل
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 والخدمات المرتبطة بها.