Felo API PlatformFelo API Platform
همه endpointهای 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