Felo API PlatformFelo API Platform
جميع endpoints الخاصة بـ DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

HTML الخام في OnPage API

الخادم:https://openapi.felo.ai
مكتبات العملاء

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

HTML الخام في OnPage API

​

HTML المخزّن لـurl واحد تم الزحف إليه. يقرأ زحفًا منتهيًا، لذا يحتاج id من post_dataforseo_on_page_submit ويعيد crawl_progress مع crawl_status من max_crawl_pages وpages_in_queue وpages_crawled — افحصها قبل الوثوق بنتيجة صغيرة، لأن الزحف الذي لا يزال جاريًا يبلّغ عن أقل فقط. ⚠️ متاح فقط إذا أُرسل الزحف مع ضبط store_raw_html — وإلا فلا شيء لإرجاعه، ولا يمكن تعديل الزحف بعد وقوعه. للمحتوى المُحلّل بدلًا من المصدر استخدم post_dataforseo_on_page_content_parsing. 💰 مجاني من المنبع: الاستعلام عن زحف منتهٍ لا يكلّف شيئًا، الزحف نفسه فقط.

مرجع التسعير

  • القياس: تكلفة الاستجابة المُبلَّغ عنها.
  • تقدير الطلب المرجعي: 0.012 دولار أمريكي.
  • مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.

بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.

الجسم
application/json
  • النوع: array (object | null)[]
    • id
      النوع: string

      معرّف المهمة
      حقل مطلوب
      يمكنك الحصول على هذا المعرّف في استجابة نقطة النهاية Task POST
      مثال:
      "07131248-1535-0216-1000-17384017ad04"

    • url
      النوع: string

      عنوان URL للصفحة
      حقل مطلوب
      عنوان URL المطلق لصفحة لطلب HTML الخاص بها
      ملاحظة: هذا الحقل اختياري إذا تم تعيين المهمة باستخدام نقطة النهاية Instant Pages

الاستجابات
  • 200
    النوع: object | null · Response36Afe1097B20_OnPageRawHtmlResponseInfo
    • cost
      النوع: number | null التنسيق: double

      إجمالي تكلفة المهام، بالدولار الأمريكي

    • status_code
      النوع: integer | null

      رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا

    • status_message
      النوع: string | null

      رسالة معلوماتية عامة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا

    • tasks
      النوع: array (object | null)[] | null

      مصفوفة المهام

      • النوع: object | null · Response36Afe1097B20_OnPageRawHtmlTaskInfo
        • cost
          النوع: number | null التنسيق: double

          إجمالي تكلفة المهام، بالدولار الأمريكي

        • data
          النوع: object | null

          يحتوي على المعاملات نفسها التي حددتها في طلب POST

          • propertyName
            النوع: object | null
        • id
          النوع: string | null

          معرّف المهمة معرّف مهمة فريد في نظامنا بصيغة UUID

        • path
          النوع: array (string | null)[] | null

          مسار URL

        • result
          النوع: array (object | null)[] | null

          مصفوفة نتائج

          • crawl_progress
            النوع: string | null

            حالة جلسة الزحف
            القيم الممكنة: in_progress، finished

          • crawl_status
            النوع: object | null · Response36Afe1097B20_CrawlStatusInfo

            تفاصيل جلسة الزحف

            • max_crawl_pages
              النوع: integer | null التنسيق: int64

              الحد الأقصى لعدد الصفحات المراد الزحف إليها يشير إلى حد max_crawl_pages الذي حددته عند إعداد المهمة

            • pages_crawled
              النوع: integer | null التنسيق: int64

              عدد الصفحات المزحوفة

            • pages_in_queue
              النوع: integer | null التنسيق: int64

              عدد الصفحات الموجودة حاليًا في قائمة انتظار الزحف

          • items
            النوع: object | null · Response36Afe1097B20_OnPageRawHtmlItem

            كائن العناصر

            • html
              النوع: string | null

              HTML_pagen

          • items_count
            النوع: integer | null التنسيق: int64

            عدد العناصر في مصفوفة النتائج

        • result_count
          النوع: integer | null التنسيق: int64

          عدد العناصر في مصفوفة result

        • status_code
          النوع: integer | null

          رمز حالة المهمة ينشئه DataForSEO ويمكن أن يقع ضمن النطاق التالي: 10000-60000 يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا

        • status_message
          النوع: string | null

          الرسالة المعلوماتية للمهمة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا

        • time
          النوع: string | null

          وقت التنفيذ، بالثواني

    • tasks_count
      النوع: integer | null التنسيق: int64

      عدد المهام في مصفوفة tasks

    • tasks_error
      النوع: integer | null التنسيق: int64

      عدد المهام في مصفوفة tasks التي أُعيدت مع خطأ

    • time
      النوع: string | null

      إجمالي وقت التنفيذ، بالثواني

    • version
      النوع: string | null

      الإصدار الحالي من API

    application/json
  • 400

    تعذّرت معالجة الطلب. تحقق من معاملات الطلب.

  • 401

    مطلوب مفتاح API صالح من Felo.

  • 402

    لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.

  • 403

    الحساب غير مصرّح له بهذه العملية.

  • 429

    تم بلوغ حد الطلبات أو حد الإنفاق.

  • 502

    تعذّر على الخدمة إكمال الطلب.

  • 503

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

  • 504

    انتهت مهلة الخدمة أثناء معالجة الطلب.

  • default

    استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد

    application/json
Request Example for post/v1/beta/dataforseo/on_page/raw_html
curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/raw_html \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "id": "07281559-0695-0216-0000-c269be8b7592",
    "url": "https://dataforseo.com/apis"
  }
]'
{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "crawl_progress": null,
          "crawl_status": {
            "max_crawl_pages": null,
            "pages_in_queue": null,
            "pages_crawled": null
          },
          "items_count": null,
          "items": {
            "html": null
          }
        }
      ]
    }
  ]
}
OnPage API Raw HTML