Felo API PlatformFelo API Platform
כל ה-endpoints של DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

סיכום ב-OnPage API

שרת:https://openapi.felo.ai
ספריות לקוח

DataForSEO

​

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

סיכום ב-OnPage API

​

המצב והמדדים הראשיים של סריקה אחת, לפי id. מחזיר crawl_progress, crawl_status, crawl_gateway_address, crawl_stop_reason, domain_info ו-page_metrics. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. זו גם הדרך לדעת שסריקה הסתיימה — סקרו אותה עד ש-crawl_progress הוא finished לפני קריאת כל נקודת קצה אחרת כאן, אחרת תקראו תוצאות חלקיות שנראות אמיתיות. 💰 חינם מהספק: שאילתה על סריקה שהסתיימה אינה עולה דבר, רק הסריקה עצמה.

מראה תמחור

  • מדידה: עלות תגובה מדווחת.
  • אומדן בקשת ייחוס: 0.012 דולר ארה״ב.
  • מכפיל לקוח לייחוס: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.

זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.

פרמטרי נתיב
  • id
    סוג: string
    חובה

    מזהה המשימה
    שדה חובה
    אפשר לקבל את המזהה הזה בתגובה של נקודת הקצה Task POST
    דוגמה:
    “07131248-1535-0216-1000-17384017ad04”

תגובות
  • 200
    סוג: object | null · Response36Afe1097B20_OnPageSummaryResponseInfo
    • cost
      סוג: number | null פורמט: double

      סך עלות המשימות, בדולר ארה״ב

    • status_code
      סוג: integer | null

      קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן

    • status_message
      סוג: string | null

      הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן

    • tasks
      סוג: array (object | null)[] | null

      מערך משימות

      • סוג: object | null · Response36Afe1097B20_OnPageSummaryTaskInfo
        • 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_gateway_address
            סוג: string | null

            כתובת ה-IP של הסורק
            מציג את כתובת ה-IP שבה משתמש הסורק כדי לפתוח את הפעלת הסריקה הנוכחית
            את הרשימה המלאה של כתובות ה-IP שבהן משתמש הסורק שלנו אפשר למצוא בקטע סקירה כללית

          • 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

              מספר העמודים שנמצאים כרגע בתור הסריקה

          • crawl_stop_reason
            סוג: string | null

            הסיבה לעצירת הסריקה
            מידע על הסיבה לעצירת תהליך הסריקה;
            ערכים אפשריים:
            limit_exceeded - חריגה מהמגבלה שהוגדרה ב-max_crawl_pages;
            empty_queue - כל כתובות ה-URL בתור נסרקו;
            force_stopped - תהליך הסריקה הופסק באמצעות On Page API Force Stop;
            unexpected_exception - אירעה שגיאה פנימית במהלך הסריקה של target, פנו לתמיכה למידע נוסף

          • domain_info
            סוג: object | null · Response36Afe1097B20_DomainInfo

            מידע ברמת הדומיין
            מידע OnPage על דומיין היעד ותהליך הסריקה

            • canonicalization_status_code
              סוג: integer | null

              קוד סטטוס המוחזר על ידי עמוד מקונון
              בדיקת התנהגות השרת כאשר הסורק שלנו מנסה לגשת לאתר דרך IP
              ברוב המקרים, מומלץ שעמודים מקונונים יחזירו קוד סטטוס 301 או 302

            • checks
              סוג: object | null

              בדיקות אתר
              בדיקות נוספות בדף הקשורות לאתר

              • propertyName
                סוג: boolean | null
            • cms
              סוג: string | null

              מערכת ניהול תוכן
              מערכת ניהול תוכן שזוהתה באתר
              התוכן של תג המטא generator
              הנתונים נלקחים מהעמוד האקראי הראשון שמחזיר קוד תגובה 200
              אם הסורק לא הצליח לזהות את מערכת ניהול התוכן, הערך יהיה null

            • crawl_end
              סוג: string | null

              הזמן שבו הסריקה הסתיימה
              התאריך והשעה שבהם הסריקה הסתיימה
              בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              לדוגמה:
              2019-11-15 12:57:46 +00:00
              הערה: למידע בלבד אם "crawl_progress" הוא "finished"
              אם "crawl_progress" הוא in_progress, הערך יהיה null

            • crawl_start
              סוג: string | null

              הזמן שבו הסריקה החלה
              התאריך והשעה שבהם האתר נשלח לסריקה
              בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              לדוגמה:
              2019-11-15 12:57:46 +00:00

            • directory_browsing_status_code
              סוג: integer | null

              קוד סטטוס המוחזר על ידי מדריך
              קוד הסטטוס המוחזר על ידי עמוד מדריך באתר יעד
              ברוב המקרים, מומלץ שמדריכים יחזירו קוד סטטוס 403 או 401

            • extended_crawl_status
              סוג: string | null

              סטטוס סריקה ושגיאות
              מציין את הסיבה לכך שאתר לא נסרק
              יכול לקבל את הערכים הבאים:
              no_errors - לא זוהו שגיאות סריקה
              site_unreachable - הסורק שלנו לא הצליח להגיע לאתר ולכן לא היה יכול לקבל קוד סטטוס
              invalid_page_status_code - קוד הסטטוס של העמוד הראשון שנסרק >= 400
              forbidden_meta_tag - העמוד הראשון שנסרק מכיל את התג <meta robots="noindex">
              forbidden_robots - robots.txt אוסר לסרוק את העמוד
              forbidden_http_header - כותרת ה-HTTP של העמוד מכילה "X-Robots-Tag: noindex"
              too_many_redirects - בעמוד הראשון שנסרק יש יותר מ-10 הפניות
              unknown - הסיבה אינה ידועה

            • ip
              סוג: string | null

              כתובת ה-IP של הדומיין

            • main_domain
              סוג: string | null

              שם הדומיין השורשי

            • name
              סוג: string | null

              שם הדומיין

            • page_not_found_status_code
              סוג: integer | null

              קוד סטטוס המוחזר על ידי עמוד שאינו קיים
              ברוב המקרים, מומלץ שהשרת יחזיר קוד תגובה 404

            • server
              סוג: string | null

              שרת האתר
              גרסת השרת שזוהתה באתר
              התוכן של כותרת server
              המידע נלקח מהעמוד הראשון שקוד התגובה שלו הוא 200

            • ssl_info
              סוג: object | null · Response36Afe1097B20_SslInfo

              מידע על תעודת SSL
              מידע על פרוטוקול Secure Sockets Layer שזוהה באתר

              • certificate_expiration_date
                סוג: string | null

                תאריך תפוגת תעודת SSL
                התאריך והשעה שבהם תעודת ה-SSL פגה
                בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                דוגמה:
                2019-11-15 12:57:46 +00:00

              • certificate_hash
                סוג: string | null

                גיבוב תעודת SSL
                הגרסה של פונקציית הגיבוב של תעודת ה-SSL

              • certificate_issuer
                סוג: string | null

                רשות תעודות SSL
                הישות שהנפיקה את תעודת ה-SSL שזוהתה

              • certificate_subject
                סוג: string | null

                נושא תעודת SSL
                הישות המשויכת למפתח הציבורי

              • certificate_version
                סוג: integer | null

                גרסת תעודת SSL
                מציין את גרסת X.509 שבה משתמשת תעודת SSL

              • valid_certificate
                סוג: boolean | null

                תוקף תעודת SSL
                מציין אם תעודת ה-SSL שזוהתה באתר אינה פגה, מושעית, מבוטלת או לא תקפה

            • total_pages
              סוג: integer | null פורמט: int64

              סך העמודים שנסרקו
              המספר הכולל של העמודים שנסרקו

            • total_uncrawlable_resources
              סוג: integer | null פורמט: int64

              סך המשאבים שלא ניתן לסרוק
              המספר הכולל של משאבים שלא ניתן היה לסרוק
              משאב נחשב כבלתי ניתן לסריקה כאשר סוג התוכן בפועל שלו אינו תואם לסוג התוכן שהסורק ציפה לו

            • www_redirect_status_code
              סוג: integer | null

              קוד סטטוס ההפניה
              קוד הסטטוס של ההפניה מ-www ל-non-www
              ברוב המקרים, מומלץ שההפניה תחזיר קוד סטטוס 301

          • page_metrics
            סוג: object | null · Response36Afe1097B20_PageMetrics

            מידע ספציפי לעמוד
            מידע מדדים על עמודי אתר היעד

            • broken_links
              סוג: integer | null

              מספר הקישורים השבורים
              מספר הקישורים השבורים בכל העמודים שנסרקו באתר יעד

            • broken_resources
              סוג: integer | null

              מספר המשאבים השבורים
              מספר התמונות ומשאבים אחרים עם קישורים שבורים

            • checks
              סוג: object | null

              בדיקות OnPage ספציפיות לעמוד

              • propertyName
                סוג: integer | null פורמט: int64

                Signed 64-bit integers (long type).

            • duplicate_content
              סוג: integer | null

              מספר העמודים עם תוכן כפול

            • duplicate_description
              סוג: integer | null

              מספר העמודים עם תיאורים כפולים

            • duplicate_title
              סוג: integer | null

              מספר העמודים עם כותרות כפולות

            • links_external
              סוג: integer | null

              מספר הקישורים החיצוניים
              מספר הקישורים שמצביעים לאתרים אחרים

            • links_internal
              סוג: integer | null

              מספר הקישורים הפנימיים
              מספר הקישורים שמצביעים לעמודים אחרים בתוך אתר היעד

            • links_relation_conflict
              סוג: integer | null

              מספר הקישורים באתר היעד שעשויים להתנגש
              לדוגמה, אם "links_relation_conflict": 2, אתר היעד מפנה לאותו מקור בלפחות קישור פנימי אחד עם המאפיין rel="nofollow" וגם בלפחות קישור dofollow אחד

            • non_indexable
              סוג: integer | null

              מספר העמודים שאינם ניתנים לאינדוקס
              מספר העמודים שחסומים לאינדוקס על ידי Google ומנועי חיפוש אחרים באמצעות robots.txt, כותרות HTTP או הגדרות תגי meta;
              אפשר לקבל רשימה של כתובות URL שאינן ניתנות לאינדוקס באמצעות נקודת הקצה הזו

            • onpage_score
              סוג: number | null

              מציג עד כמה האתר מותאם, בסולם של 100 נקודות
              שדה זה מציג עד כמה האתר מותאם בהתחשב בבעיות חמורות ובאזהרות שזוהו בעמוד;
              100 הוא הציון הגבוה ביותר האפשרי, שמשמעותו שלאתר אין בעיות חמורות או אזהרות חשובות בעמוד;
              שימו לב שהערך תלוי במספר העמודים שנסרקו;
              מידע נוסף על אופן חישוב המדד זמין במאמר מרכז העזרה הזה

            • redirect_loop
              סוג: integer | null

              מספר שרשראות ההפניה שמתחילות ומסתיימות באותה כתובת URL
              מספר שרשראות ההפניה שבהן כתובת ה-URL של היעד מפנה חזרה לכתובת ה-URL המקורית

        • 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 get/v1/beta/dataforseo/on_page/summary/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/summary/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "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
          },
          "crawl_gateway_address": null,
          "crawl_stop_reason": null,
          "domain_info": {
            "name": null,
            "cms": null,
            "ip": null,
            "server": null,
            "crawl_start": null,
            "crawl_end": null,
            "extended_crawl_status": null,
            "ssl_info": "[Max Depth Exceeded]",
            "checks": null,
            "total_pages": null,
            "total_uncrawlable_resources": null,
            "page_not_found_status_code": null,
            "canonicalization_status_code": null,
            "directory_browsing_status_code": null,
            "www_redirect_status_code": null,
            "main_domain": null
          },
          "page_metrics": {
            "links_external": null,
            "links_internal": null,
            "duplicate_title": null,
            "duplicate_description": null,
            "duplicate_content": null,
            "broken_links": null,
            "broken_resources": null,
            "links_relation_conflict": null,
            "redirect_loop": null,
            "onpage_score": null,
            "non_indexable": null,
            "checks": null
          }
        }
      ]
    }
  ]
}
OnPage API Summary