تخطي إلى المحتوى
POST AI agent ready /v1/social-preview/extract

واجهة برمجة تطبيقات Social Preview - استخراج العلامات الوصفية للرسم البياني المفتوح وبطاقة Twitter

جلب عنوان URL واستخراج علامات Open Graph (og:title، og:description، og:image، og:type، og:site_name)، علامات بطاقة Twitter (twitter:card، twitter:title، twitter:image، twitter:site، twitter:creator)، وبيانات تعريف HTML العامة (العنوان، الوصف، الأساسي، الرمز المفضل). إرجاع تحذيرات للعلامات المفقودة أو المشوهة.

Parameters

stringrequired

URL to extract social preview metadata from.

Code examples

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

When to use this API

ربط بطاقات المعاينة في منصات الدردشة ونظام إدارة المحتوى (CMS).

عندما يقوم مستخدم بلصق عنوان URL في تطبيقك، اتصل بنقطة النهاية هذه لجلب بيانات Open Graph وتقديم بطاقة معاينة رابط غنية بالعنوان والوصف والصورة. يعمل من أجل فتح رابط نمط Slack.

تدقيق SEO للمشاركة الاجتماعية

قم بمسح صفحاتك ضوئيًا للتحقق من وجود علامات Open Graph وTwitter Card ومن تنسيقها بشكل صحيح. احصل على علامات og:image المفقودة أو الأوصاف المقتطعة قبل بدء حملات المشاركة.

إثراء نظام إدارة المحتوى

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

Frequently asked questions

ماذا يحدث إذا كانت الصفحة لا تحتوي على علامات Open Graph؟
يقوم قسم og بإرجاع قيم فارغة للعلامات المفقودة. يعود القسم العام إلى علامتي HTML <title> و<meta name="description">. تتم إضافة تحذير لكل علامة OG مفقودة.
هل هذا يتبع عمليات إعادة التوجيه؟
نعم. تتابع نقطة النهاية ما يصل إلى 5 عمليات إعادة توجيه وتستخرج البيانات الوصفية من عنوان URL المقصود النهائي.
هل يمكنني استخراج البيانات الوصفية من الصفحات التي تتطلب JavaScript؟
لا. تقوم نقطة النهاية بجلب استجابة HTML الأولية. ستعيد التطبيقات ذات الصفحة الواحدة التي تحقن علامات OG عبر JavaScript بيانات تعريف غير مكتملة. تعمل الصفحات المعروضة بواسطة الخادم بشكل صحيح.
ما هي التحذيرات الشائعة التي تم إرجاعها؟
تتضمن التحذيرات فقدان og:title، وog:image، وog:description أطول من 200 حرف، وعلامات Twitter Card المفقودة، وعناوين URL og:image التي تعرض أنواع محتوى غير الصور.
هل تم التحقق من صحة عنوان URL لـ og:image؟
تقوم نقطة النهاية بإرجاع عنوان URL لـ og:image كما هو من HTML. ولا يقوم بإحضار الصورة للتحقق من وجودها أو التحقق من أبعادها. استخدم طلب HEAD منفصلًا للتحقق من صحة عنوان URL للصورة.

Get your API key

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