Scrape API: جلب صفحات الويب بتسعير ثابت بالأرصدة

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

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

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

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

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

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

توفر الوثائق الواضحة والطلبات الموثقة وتفاصيل الاعتمادية المرئية طريقة أسهل لتقييم 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

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

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

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

معلمات الطلب

المعامل

urlmodeoutputurlsjob_idlimitoffset

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

مثال الرد

datadata.urldata.final_urldata.statusdata.outcomedata.content_typedata.contentdata.bytesdata.truncateddata.redirect_countdata.attempt_countdata.duration_ms

تغطية الحالة

رموز حالة HTTP

200202400401402403409429503

نقاط النهاية

POST /v1/scrape

الرصيد: 1-20/itemالمصادقة: المصادقة مطلوبة

urlmodeoutput

POST /v1/scrape/jobs

الرصيد: 1-20/itemالمصادقة: المصادقة مطلوبة

modeoutputurls

GET /v1/scrape/jobs/:job_id

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

job_id

GET /v1/scrape/jobs/:job_id/results

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

job_idlimitoffset

اختر جهد الجلب لكل عنوان URL

تُحتسب الأرصدة بناءً على الوضع الذي تطلبه، لا على حالة HTTP أو المحتوى الذي يعيده الموقع المستهدف.

قياسي

رصيد واحد لكل عنوان URL

محاولة جلب قياسية واحدة للصفحات البسيطة.

مرن

رصيدان لكل عنوان URL

محاولة قياسية واحدة مع إعادة محاولة واحدة عندما تستوفي النتيجة شروط إعادة المحاولة الموثقة.

عرض

10 أرصدة لكل عنوان URL

محاولة واحدة للعرض عبر المتصفح للصفحات التي تتطلب تنفيذ JavaScript.

عرض مرن

20 رصيدًا لكل عنوان URL

محاولة واحدة للعرض عبر المتصفح مع إعادة محاولة واحدة عندما تستوفي النتيجة شروط إعادة المحاولة الموثقة.

تُحتسب تكلفة الأوضاع المرنة المذكورة حتى عند نجاح المحاولة الأولى. وهي تتضمن إعادة محاولة مؤهلة واحدة، لا إعادة محاولات غير محدودة ولا ضمانًا بأن يعيد الموقع المستهدف المحتوى الذي تتوقعه.

تعكس الفوترة العمل المطلوب

تعني عملية API الناجحة أن DomScan نفّذ وضع الجلب المحدد وأعاد الاستجابة الناتجة من الموقع المستهدف.

قد تظل النتيجة إعادة توجيه أو خطأ HTTP أو استجابة محجوبة أو صفحة تحدٍّ أو صفحة فارغة أو محتوى لا يلبي احتياجاتك. هذه نتائج من الموقع المستهدف، وتخضع للفوترة ولا تستحق رد الأرصدة.

يتاح رد الرصيد فقط عندما تتحقق DomScan من أن منصتها نفسها أخفقت في تنفيذ وضع الجلب المحدد.

لا يضمن العرض عبر المتصفح نجاح تحميل الصفحة، كما لا تضمن الأوضاع المرنة أن تنتج إعادة المحاولة نتيجة مختلفة.

حدود الاستخدام الخاصة بـ Scrape API

تنطبق هذه الحدود تحديدًا على Scrape API. وقد تنطبق أيضًا وسائل حماية أخرى على الحساب والمنصة.

القدرة	الحسابات المجانية	الحسابات المدفوعة
الأوضاع المتاحة	القياسي فقط	الأوضاع الأربعة كلها
معدل الطلبات	5 طلبات في الدقيقة	60 طلبًا في الدقيقة
الطلبات القياسية أو المرنة المتزامنة	طلب قياسي واحد	5 طلبات
الطلبات المعروضة المتزامنة	غير متاح	طلبان
الحصة اليومية	100 طلب	بناءً على الأرصدة المتاحة وحدود المعدل
الحصة الشهرية	500 طلب	بناءً على الأرصدة المتاحة وحدود المعدل
الحد الأقصى للمحتوى المعاد	256 KiB لكل طلب	512 KiB لكل طلب
الدفعات غير المتزامنة	غير متاح	متاح

عندما تتجاوز الاستجابة حد المحتوى المطبق، تعيد API الجزء المسموح به وتضع علامة تفيد بأن الاستجابة مقتطعة.

معالجة ما يصل إلى 100 عنوان URL بشكل غير متزامن

يمكن للحسابات المدفوعة إرسال مهمة غير متزامنة تتضمن ما يصل إلى 100 عنوان URL.

ما يصل إلى 5 مهام دفعات جديدة في الدقيقة

ما يصل إلى 3 مهام نشطة لكل حساب

ما يصل إلى 300 عنصر URL في قائمة الانتظار لكل حساب

ما يصل إلى 100 عنوان URL في المهمة الواحدة

النتائج المكتملة متاحة لمدة 24 ساعة

يُحتفظ ببيانات المهمة الوصفية لمدة 7 أيام

تُحتسب تكلفة كل عنوان URL بشكل مستقل باستخدام الوضع المحدد له.

نزّل النتائج المكتملة أو انسخها خلال 24 ساعة. بعد هذه المدة، يُحذف محتوى الاستجابة حتى مع بقاء بيانات وصفية محدودة للمهمة متاحة لمدة 7 أيام.

نطاق واضح من دون خيارات ترقية مخفية

لا نحل CAPTCHA

يمكن للعرض عبر المتصفح تنفيذ JavaScript الخاص بالصفحة، لكن Scrape API لا يحل CAPTCHA ولا يتجاوز متطلبات تسجيل الدخول أو جدران الدفع أو ضوابط الوصول أو القيود الأخرى. صفحة CAPTCHA أو التحدي التي يعيدها الموقع المستهدف هي نتيجة من الموقع المستهدف ولا تستحق رد الرصيد.

لا يتوفر اختيار وكيل متميز

تختار وضع الجلب ومستوى الجهد. لا يوجد معامل لاختيار وكيل متميز أو مزود أو مجموعة أو بلد.

الاستخدام المقبول

استخدم Scrape API فقط للمحتوى المسموح لك قانونًا بالوصول إليه ومعالجته. أنت مسؤول عن الامتثال للقوانين المعمول بها وشروط الموقع المستهدف والتزامات الخصوصية والأذونات المطلوبة.

لا تستخدم API لتجاوز المصادقة أو جدران الدفع أو CAPTCHA أو ضوابط الوصول، ولا لهجمات بيانات الاعتماد أو إساءة استخدام الحسابات أو المضايقة أو المراقبة غير القانونية أو جمع البيانات الشخصية بصورة غير قانونية. قد ترفض DomScan الطلبات أو تعلق الوصول عندما يهدد الاستخدام الأشخاص أو الخدمات أو المنصة.

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

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

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

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

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

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

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

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

نشط طلب مثال

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

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

اختر جهد الجلب لكل عنوان URL

تُحتسب الأرصدة بناءً على الوضع الذي تطلبه، لا على حالة HTTP أو المحتوى الذي يعيده الموقع المستهدف.

تعكس الفوترة العمل المطلوب

تعني عملية API الناجحة أن DomScan نفّذ وضع الجلب المحدد وأعاد الاستجابة الناتجة من الموقع المستهدف.

معالجة ما يصل إلى 100 عنوان URL بشكل غير متزامن

يمكن للحسابات المدفوعة إرسال مهمة غير متزامنة تتضمن ما يصل إلى 100 عنوان URL.

حدود الاستخدام الخاصة بـ Scrape API

تنطبق هذه الحدود تحديدًا على Scrape API. وقد تنطبق أيضًا وسائل حماية أخرى على الحساب والمنصة.

لا نحل CAPTCHA

الاستخدام المقبول

طلب مثال

طلب قياسي bash

curl -X POST "https://domscan.net/v1/scrape" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/","mode":"standard","output":"markdown"}'

طلب معروض عبر المتصفح bash

curl -X POST "https://domscan.net/v1/scrape" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/app","mode":"rendered","output":"html"}'

طلب دفعة غير متزامنة bash

curl -X POST "https://domscan.net/v1/scrape/jobs" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Idempotency-Key: docs-batch-1" \
  -H "Content-Type: application/json" \
  -d '{"mode":"standard","output":"text","urls":["https://example.com/page-1","https://example.com/page-2"]}'

مثال الرد

استجابة قياسية ناجحة json

{
  "data": {
    "url": "https://example.com/",
    "final_url": "https://example.com/",
    "status": 200,
    "outcome": "success",
    "content_type": "text/html",
    "content": "<!doctype html>...",
    "bytes": 1256,
    "truncated": false,
    "redirect_count": 0,
    "attempt_count": 1,
    "duration_ms": 428,
    "fetched_at": "2026-08-20T10:30:00.000Z",
    "headers": { "cache-control": "max-age=604800" },
    "rendered": false
  },
  "billing": {
    "credits_charged": 1,
    "credits_refunded": 0,
    "policy": "effort_based"
  }
}

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

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

يكلف عنوان URL واحد 1 أو 2 أو 10 أو 20 رصيدًا، بحسب الوضع المحدد. تستخدم عناصر الدفعة التسعير نفسه لكل عنوان URL.

هل تُفرض عليّ رسوم إذا أعاد الموقع المستهدف صفحة خطأ أو حظر؟

نعم. تخضع استجابات الموقع المستهدف مثل عمليات إعادة التوجيه وأخطاء HTTP وعمليات الحظر وصفحات التحدي والصفحات الفارغة أو المحتوى غير المتوقع للفوترة، لأن DomScan نفّذت عمل الجلب المطلوب رغم ذلك.

متى يُرد الرصيد عن الطلب؟

يتاح رد الرصيد فقط عندما تتحقق DomScan من أن منصتها نفسها أخفقت في تنفيذ وضع الجلب المحدد. ولا يُعد سلوك الموقع المستهدف إخفاقًا في المنصة.

هل يواصل الوضع المرن إعادة المحاولة حتى تعمل الصفحة؟

لا. يتضمن الوضع المرن إعادة محاولة واحدة عندما تستوفي النتيجة الأولى شروط إعادة المحاولة الموثقة.

هل يحل العرض عبر المتصفح CAPTCHA؟

لا. ينفذ JavaScript الخاص بالصفحة، لكنه لا يحل CAPTCHA ولا يتجاوز قيود الوصول.

هل يمكنني اختيار وكيل متميز أو بلد؟

لا. لا تعرض API مستويات الوكلاء أو مزوديها أو مجموعاتها أو استهداف بلد معين. يمكنك اختيار وضع الجلب فقط.

هل يمكن للحسابات المجانية إرسال مهام دفعات؟

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

إلى متى تُخزَّن نتائج الدفعة؟

يتاح محتوى الاستجابة المكتملة لمدة 24 ساعة. وتظل بيانات وصفية محدودة للمهمة متاحة لمدة 7 أيام.

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

رموز حالة HTTP

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

OK 200

نجح الطلب

مقبول 202

تم قبول عدم العثور على نتيجة مخزنة مؤقتًا للنطاقات الفرعية في وضع التخزين المؤقت فقط لتحديثها في الخلفية. لا تُخصم أي أرصدة؛ أعد المحاولة بعد مدة Retry-After.

طلب غير صالح 400

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

غير مصرح 401

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

الدفع مطلوب 402

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

محظور 403

تمت المصادقة، ولكن غير مسموح لك باستخدام هذه العملية أو الوضع.

HTTP 409 409

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

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

الخدمة غير متاحة 503

الخدمة الخلفية غير متاحة أو تفرض تحديد معدل مؤقتًا.

احصل على مفتاح API

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

الدعم

واجهة API لـ استخراج بيانات الويب

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

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

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

عدة المطور

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

نقاط النهاية

اختر جهد الجلب لكل عنوان URL

قياسي

مرن

عرض

عرض مرن

تعكس الفوترة العمل المطلوب

حدود الاستخدام الخاصة بـ Scrape API

معالجة ما يصل إلى 100 عنوان URL بشكل غير متزامن

نطاق واضح من دون خيارات ترقية مخفية

لا نحل CAPTCHA

لا يتوفر اختيار وكيل متميز

الاستخدام المقبول

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

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

طلب مثال

مثال الرد

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

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

رموز حالة HTTP