تخطي إلى المحتوى
POST AI agent ready /v1/url-metadata

واجهة برمجة تطبيقات بيانات تعريف URL - استخراج الرسم البياني المفتوح والعنوان والرمز المفضل

جلب عنوان URL واستخراج العنوان والوصف وعلامات الرسم البياني المفتوح وعلامات بطاقة Twitter والأيقونة المفضلة وعنوان URL الأساسي واللغة والمؤلف والكلمات الرئيسية ولون السمة. مفيد لمعاينات الارتباط والمشاركة الاجتماعية.

Parameters

stringrequired

Full URL to fetch and extract metadata from.

Code examples

curl -X POST https://api.botoi.com/v1/url-metadata \
  -H "Content-Type: application/json" \
  -d '{"url":"https://github.com"}'

When to use this API

قم بإنشاء معاينات روابط غنية في تطبيق الدردشة

عندما يقوم مستخدم بلصق عنوان URL في رسالة دردشة، اتصل بنقطة النهاية هذه لجلب العنوان والوصف وصورة OG. اعرض بطاقة معاينة أسفل الرسالة، على غرار الطريقة التي يظهر بها رابط عرض Slack أو Discord.

التحقق من صحة علامات OG قبل نشر المحتوى

قبل مشاركة منشور مدونة على وسائل التواصل الاجتماعي، استخرج علامات OG الخاصة به للتأكد من صحة العنوان والوصف والصورة. احصل على البيانات الوصفية المفقودة أو المقتطعة قبل نشرها على Twitter أو LinkedIn أو Facebook.

أنشئ مدير إشارات مرجعية باستخدام بيانات التعريف التلقائية

عندما يقوم المستخدم بحفظ عنوان URL في مجموعة الإشارات المرجعية الخاصة به، قم بملء العنوان والوصف والصورة المصغرة تلقائيًا من البيانات التعريفية المستخرجة. حفظ المستخدم من إدخال التفاصيل يدويًا لكل إشارة مرجعية.

Frequently asked questions

هل تتبع نقطة النهاية هذه عمليات إعادة التوجيه؟
نعم. تتبع نقطة النهاية عمليات إعادة توجيه HTTP وتستخرج البيانات التعريفية من عنوان URL المقصود النهائي. يعكس حقل الحالة حالة HTTP للاستجابة النهائية.
ما الفرق بين حقلي og وtwitter؟
يحتوي og على علامات تعريف Open Graph (التي يستخدمها Facebook وLinkedIn وغيرهما). يحتوي تويتر على علامات بطاقة تويتر. تقوم العديد من المواقع بتعيين كليهما، لكن علامات بطاقة Twitter لها الأولوية على Twitter/X عند وجودهما معًا.
هل يمكنني استخراج البيانات الوصفية من تطبيقات الصفحة الواحدة؟
تقوم نقطة النهاية بجلب استجابة HTML الأولية دون تنفيذ JavaScript. إذا قامت SPA بعرض علامات التعريف الخاصة بها من جانب العميل، فلن تظهر هذه العلامات في الاستجابة.
هل هناك مهلة لعناوين URL البطيئة؟
نعم. تنتهي مهلة نقطة النهاية بعد 10 ثوانٍ إذا لم يستجب عنوان URL المستهدف. ترجع المهلة خطأ 400 مع رسالة وصفية.
ماذا يحتوي الحقل الكنسي؟
يحتوي الحقل الأساسي على قيمة العلامة <link rel="canonical">، والتي تشير إلى عنوان URL المفضل للصفحة. يساعدك هذا على إلغاء تكرار عناوين URL التي تخدم نفس المحتوى.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.