واجهة API لبيانات URL التعريفية ومعاينات الروابط واستخبارات الويب

واجهة API لـ استخبارات URL موحّدة

أرسل URL عاماً وتلقَّ في استجابة واحدة بيانات تعريف الصفحة الموحّدة وأصول المعاينة ودليل إعادة التوجيه وأنواع البيانات المنظّمة وترويسات الأمان وإشارات الهوية العامة.

{ "requested_url": "https://example.com/", "final_url": "https://example.com/", "status": 200, "title": "Example Domain", "canonical_url": "https://example.com/", "open_graph": {}, "structured_data": { "types": [], "items": 0, "parse_errors": 0 }, "meta": { "cached": false, "fetch_transport": "worker" } }

Category بيانات الويب

نقاط النهاية 2

الميزات الرئيسية 6

الأسئلة الشائعة 5

يستخدمه أشخاص في شركات مميزة

إشارات ثقة قبل التكامل

توفر الوثائق الواضحة والطلبات الموثقة وتفاصيل الاعتمادية المرئية طريقة أسهل لتقييم DomScan قبل الإطلاق.

مباشر حالة الخدمة

تحقق من حالة الخدمة المباشرة واستجابات الفشل الموثقة قبل التكامل.

OpenAPI ملفات API

روابط OpenAPI وSwagger وPostman وCLI وSDK وMCP متاحة بنقرة واحدة.

مفاتيح API وصول محمي

تستخدم نقاط النهاية الموثقة مفاتيح API مع تكاليف رصيد واضحة قبل الاستدعاء.

10,000 حصة مجانية

ابدأ مع 10,000 رصيد شهري وقم بالترقية فقط عند نمو الاستخدام.

ما الذي تساعدك هذه الواجهة على إطلاقه

استخدم هذه الصفحة كملخص إنتاج: نقاط النهاية، الأمثلة، شكل الاستجابة، وأجزاء سير العمل اللازمة لربط DomScan بمنتجك.

سير عمل المنتج

ادمج فحوصات النطاقات، معلومات DNS، إشارات المخاطر أو الإثراء داخل الإعداد، البحث والأدوات الداخلية.

أتمتة المحللين

استبدل عمليات البحث اليدوية المتكررة بمهام مجدولة وتنبيهات وخطوات تحقيق قابلة للإعادة.

بيانات JSON نظيفة

استخدم حقولًا متوقعة، رموز حالة موثقة وتكاليف ائتمان بدلًا من كشط صفحات المزودين.

أدوات الذكاء الاصطناعي والعمليات

زوّد الوكلاء ولوحات المعلومات ودفاتر SOAR وCRMs عبر OpenAPI أو SDK أو Postman أو MCP.

سير عمل التكامل

مسار بسيط من أول طلب إلى استخدام إنتاجي قابل للتكرار.

المصادقة مرة واحدة

أرسل مفتاح API مع الترويسة الموثقة وحافظ على اتساق الطلبات عبر الخدمات.

الاستعلام باستخدام الأمثلة

ابدأ من أمثلة curl وHTTP ثم اربط المعلمات بكود تطبيقك.

التشغيل والمراقبة

استخدم رموز الحالة وتكاليف الاعتمادات وحقول الاستجابة لبناء إعادة المحاولة والسجلات والتنبيهات.

عدة المطور

انتقل من هذه الصفحة إلى وثائق قابلة للقراءة آليًا، مجموعات طلبات، SDKs أو أدوات للوكلاء.

مخطط OpenAPI

أنشئ عملاء أو افحص شكل كل طلب واستجابة.

مجموعة Postman

استورد طلبات جاهزة للاختبار اليدوي وتسليم الفريق.

SDKs وCLI

استخدم حزمًا مصانة وسير عمل سطر الأوامر بدل كتابة boilerplate.

تكامل MCP

اعرض ذكاء النطاقات لوكلاء الذكاء الاصطناعي وسير عمل المساعدين الداخليين.

خريطة المعلمات والاستجابة

راجع المدخلات وحقول الإخراج ورموز الحالة قبل توصيل نقطة النهاية بعميلك.

معلمات الطلب

المعامل

urlskip_cacheurls

حقول الاستجابة

مثال الرد

requested_urlfinal_urlstatustitlecanonical_urlopen_graphstructured_datastructured_data.typesstructured_data.itemsstructured_data.parse_errorsmetameta.cached

تغطية الحالة

رموز حالة HTTP

200400401402429502

نقاط النهاية

GET /v1/url-intelligence

الرصيد: 2المصادقة: المصادقة مطلوبة

POST /v1/url-intelligence/bulk

الرصيد: 2/itemالمصادقة: المصادقة مطلوبة

إشارات ثقة قبل التكامل

توفر الوثائق الواضحة والطلبات الموثقة وتفاصيل الاعتمادية المرئية طريقة أسهل لتقييم DomScan قبل الإطلاق.

حالة الخدمة ملفات API

روابط OpenAPI وSwagger وPostman وCLI وSDK وMCP متاحة بنقرة واحدة.

مفاتيح API وصول محمي

تستخدم نقاط النهاية الموثقة مفاتيح API مع تكاليف رصيد واضحة قبل الاستدعاء.

حصة مجانية اشترك مجاناً

ابدأ مع 10,000 رصيد شهري وقم بالترقية فقط عند نمو الاستخدام.

نشط طلب مثال

ابدأ من أمثلة curl وHTTP ثم اربط المعلمات بكود تطبيقك.

الميزات الرئيسية

بيانات تعريف الصفحة الموحّدة

استخرج العنوان والوصف واللغة ونوع المحتوى وURL النهائي وURL الأساسي.

حقول معاينة الروابط

أنشئ بطاقات معاينة من الصور والأيقونات المفضلة ووسوم Open Graph وبطاقات Twitter الموحّدة.

ملخص البيانات المنظّمة

حدد أنواع JSON-LD وأبلغ عن الكتل غير الصالحة من دون إعادة بيانات صفحة غير محدودة.

إشارات الروبوتات والأمان

اقرأ توجيهات قابلية الفهرسة ومجموعة مسموح بها من ترويسات الأمان العامة.

جهات الاتصال والملفات العامة

استخرج روابط البريد الإلكتروني والهاتف والتواصل الاجتماعي والمطورين ومنشئي المحتوى المعلنة.

بيانات URL المجمعة

افحص حتى 10 عناوين URL في كل طلب مع تزامن محدود وأخطاء لكل عنصر.

طلب مثال

GET /v1/url-intelligence?url=https://example.com bash

curl -G -H "X-API-Key: $DOMSCAN_API_KEY" --data-urlencode "url=https://example.com" https://domscan.net/v1/url-intelligence

POST /v1/url-intelligence/bulk bash

curl -X POST -H "X-API-Key: $DOMSCAN_API_KEY" -H "Content-Type: application/json" \
  -d '{"urls":["https://example.com","https://github.com/about"]}' https://domscan.net/v1/url-intelligence/bulk

مثال الرد

200 OK json

{
  "requested_url": "https://example.com/",
  "final_url": "https://example.com/",
  "status": 200,
  "title": "Example Domain",
  "canonical_url": "https://example.com/",
  "open_graph": {},
  "structured_data": { "types": [], "items": 0, "parse_errors": 0 },
  "meta": { "cached": false, "fetch_transport": "worker" }
}

الأسئلة الشائعة

ما الفرق بين API لبيانات URL التعريفية وAPI لـ Open Graph؟

تركز API لـ Open Graph على الوسوم الاجتماعية. أما DomScan فتعيد أيضاً إشارات URL الأساسية وإعادة التوجيه والروبوتات والبيانات المنظّمة والأمان وجهات الاتصال والهوية.

ماذا يحدث عند غياب وسوم Open Graph؟

تبقى حقول Open Graph فارغة، بينما تظل العناوين والأوصاف والأيقونات والبيانات المنظّمة والإشارات الأخرى المتاحة مُعادة.

هل تنفذ API JavaScript؟

لا. يفحص الإصدار الأول استجابات HTML العامة محدودة الحجم، ولا يدّعي وجود بيانات تعريف لا تظهر إلا بعد تشغيل JavaScript من جهة العميل.

هل تتبع API عمليات إعادة التوجيه بأمان؟

نعم. عمليات إعادة التوجيه محدودة، ويُفحص كل هدف لمنع الوصول إلى أهداف الشبكات الخاصة أو الداخلية.

هل يمكنني فحص عدة عناوين URL معاً؟

نعم. تقبل نقطة النهاية المجمعة حتى 10 عناوين URL عامة وتحافظ على ترتيب الإدخال.

الأدوات والموارد ذات الصلة

رموز حالة HTTP

نوثّق رموز حالة HTTP التي يجب على عميلك التعامل معها حتى تتمكن من التمييز بين الاستجابات الناجحة ومشكلات المصادقة والأرصدة وحدود المعدل والبيانات غير الموجودة وأعطال الخدمة الخارجية.

OK 200

نجح الطلب

طلب غير صالح 400

معلمات غير صالحة

غير مصرح 401

مفتاح API أو الجلسة مفقود أو غير صالح.

الدفع مطلوب 402

لا توجد أرصدة كافية لتنفيذ هذا الطلب.

طلبات كثيرة جداً 429

تم تجاوز حد المعدل

بوابة غير صالحة 502

خطأ RDAP من المصدر upstream

أنشئ باستخدام استخبارات URL

ابدأ مجاناً عرض الوثائق