v0.2.0-beta

OpenAPI 3.1.0

משאבים ב-OnPage API

Felo API Support

MIT

שרת

https://openapi.felo.ai

ספריות לקוח

Shell Curl

DataForSEO

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

DataForSEO פעולות

post/v1/beta/dataforseo/on_page/resources

משאבים ב-OnPage API

הנכסים שאינם דפים שמצאה הסריקה — תמונות, סקריפטים וגיליונות סגנון — עם קודי הסטטוס והגדלים שלהם. דפים עם search_after_token. קורא סריקה שהסתיימה, ולכן זקוק ל-id מ-post_dataforseo_on_page_submit ומחזיר crawl_progress עם crawl_status של max_crawl_pages, pages_in_queue ו-pages_crawled — בדקו אותם לפני שמסתמכים על תוצאה קטנה, כי סריקה שעדיין רצה פשוט מדווחת על פחות. לנכסים שהזחלן לא הצליח להגיע אליהם כלל השתמשו ב-post_dataforseo_on_page_uncrawlable_resources. 💰 חינם מהספק: שאילתה על סריקה שהסתיימה אינה עולה דבר, רק הסריקה עצמה.

מראה תמחור

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

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

גוף

application/json

סוג: array (object | null)[]
- filters
  סוג: array (object | null)[] | null
  
  מערך של פרמטרים לסינון תוצאות
  שדה אופציונלי
  אפשר להוסיף כמה מסננים בבת אחת (8 מסננים לכל היותר)
  יש להגדיר אופרטור לוגי and או or בין התנאים
  האופרטורים הבאים נתמכים:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
  אפשר להשתמש באופרטור % עם like ו-not_like כדי להתאים כל מחרוזת של אפס תווים או יותר
  דוגמה:
  ["resource_type","=","stylesheet"]
  
  [["resource_type","=","image"], "and",["checks.is_https","=",false]]
  
  [["fetch_timing.duration_time",">",1],"and",[["total_transfer_size",">",100],"or",["checks.high_loading_time","=",true]]]
  
  הרשימה המלאה של המסננים האפשריים זמינה בקישור הזה.
  
  אובייקט ריק
- id
  סוג: string
  
  מזהה המשימה
  שדה חובה
  אפשר לקבל את המזהה הזה בתגובה של נקודת הקצה Task POST
  דוגמה:
  "07131248-1535-0216-1000-17384017ad04"
- limit
  סוג: integer | null
  
  מספר המשאבים המרבי המוחזר
  שדה אופציונלי
  ערך ברירת מחדל: 100
  ערך מרבי: 1000
- offset
  סוג: integer | null
  
  היסט במערך התוצאות של משאבים מוחזרים
  שדה אופציונלי
  ערך ברירת מחדל: 0
  ערך מרבי: 2000000
  אם מציינים את הערך 10, עשרת המשאבים הראשונים במערך התוצאות יושמטו והנתונים יסופקו עבור המשאבים העוקבים
- order_by
  סוג: array string[] | null
  
  כללי מיון תוצאות
  שדה אופציונלי
  אפשר להשתמש באותם ערכים כמו במערך filters כדי למיין את התוצאות
  סוגי מיון אפשריים:
  asc - התוצאות ימוינו בסדר עולה
  desc - התוצאות ימוינו בסדר יורד
  יש להשתמש בפסיק כדי להגדיר סוג מיון
  דוגמה:
  ["size,desc"]
  שימו לב שאין להגדיר יותר משלושה כללי מיון בבקשה אחת
  יש להשתמש בפסיק כדי להפריד בין כמה כללי מיון
  דוגמה:
  ["size,desc","fetch_timing.fetch_end,desc"]
- relevant_pages_filters
  סוג: array string[] | null
  
  סינון המשאבים לפי עמודים רלוונטיים
  שדה אופציונלי
  אפשר להשתמש בשדה הזה כדי לקבל משאבים מעמודים שמתאימים לפרמטרים שהוגדרו
  אפשר להחיל כאן את אותם המסננים הזמינים בנקודת הקצה pages
  אפשר להוסיף כמה מסננים בבת אחת (8 מסננים לכל היותר)
  יש להגדיר אופרטור לוגי and או or בין התנאים
  האופרטורים הבאים נתמכים:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
  אפשר להשתמש באופרטור % עם like ו-not_like כדי להתאים כל מחרוזת של אפס תווים או יותר
  דוגמה:
  ["checks.no_image_title","=",true]
- search_after_token
  סוג: string | null
  
  טוקן לבקשות המשך
  שדה אופציונלי
  מסופק בשדה המקביל בתגובה לכל בקשה;
  השתמשו בפרמטר זה כדי להימנע מפסקי זמן בעת ניסיון לקבל יותר מ-20,000 תוצאות בבקשה אחת;
  ציון ערך search_after_token ייחודי ממערך התגובה יניב את תוצאות ההמשך של המשימה הראשונית;
  ערכי search_after_token ייחודיים לכל משימת המשך;
  הערה: אם search_after_token מצוין בבקשה, כל שאר הפרמטרים צריכים להיות זהים לבקשה הקודמת
- tag
  סוג: string | null
  
  מזהה משימה מוגדר על ידי המשתמש
  שדה אופציונלי
  מגבלת התווים היא 255
  אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
  את ערך ה-tag שציינתם תמצאו באובייקט data של התגובה
- url
  סוג: string | null
  
  כתובת URL של עמוד
  שדה אופציונלי
  ציינו את השדה הזה אם ברצונכם לקבל את המשאבים של עמוד מסוים
  שימו לב שכדי לקבל את ה-meta של משאב מכתובת URL מסוימת, יש לציין את כתובת ה-URL בשדה הזה;
  אם לא מציינים url בעת הגדרת משימה, ה-meta של המשאב בתוצאות יוחזר על בסיס הנתונים מהעמוד שבו הסורק שלנו ראה את המשאב לראשונה

תגובות

200
סוג: object | null · Response36Afe1097B20_OnPageResourcesResponseInfo
cost
סוג: number | null פורמט: double

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

status_code
סוג: integer | null

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

status_message
סוג: string | null

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

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

מערך משימות

סוג: object | null · Response36Afe1097B20_OnPageResourcesTaskInfo
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

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

current_offset
סוג: integer | null

Integer numbers.

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

מערך הפריטים

cache_control
סוג: object | null · Response36Afe1097B20_CacheControl

הוראות לשמירה במטמון

cachable
סוג: boolean | null

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

ttl
סוג: integer | null

זמן חיים: משך הזמן שבו הדפדפן שומר משאב במטמון

checks
סוג: object | null

בדיקות אתר: בדיקות בתוך העמוד הקשורות לעמוד

propertyName
סוג: boolean | null
content_encoding
סוג: string | null

סוג הקידוד

encoded_size
סוג: integer | null

גודל העמוד לאחר קידוד: מציין את גודל העמוד המקודד בבייטים

fetch_time
סוג: string | null

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

last_modified
סוג: object | null · Response36Afe1097B20_LastModified

מכיל נתונים על שינויים הקשורים למשאב. אם אין נתונים, הערך יהיה null

header
סוג: string | null

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

meta_tag
סוג: string | null

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

sitemap
סוג: string | null

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

location
סוג: string | null

כותרת מיקום: מציינת את כתובת ה-URL שאליה יש להפנות עמוד

media_type
סוג: string | null

סוגי מדיה המשמשים להצגת עמוד

resource_errors
סוג: object | null · Response36Afe1097B20_OnPageResourceIssueInfo

שגיאות ואזהרות של המשאב

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

שגיאות משאבים

column
סוג: integer | null

העמודה שבה נמצאה השגיאה

line
סוג: integer | null

השורה שבה נמצאה השגיאה

message
סוג: string | null

הודעת טקסט של השגיאההרשימה המלאה של שגיאות HTML אפשריות זמינה כאן

status_code
סוג: integer | null

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

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

אזהרות משאבים

column
סוג: integer | null

העמודה שבה נמצאה השגיאה

line
סוג: integer | null

השורה שבה נמצאה השגיאה

message
סוג: string | null

הודעת טקסט של השגיאההרשימה המלאה של שגיאות HTML אפשריות זמינה כאן

status_code
סוג: integer | null

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

resource_type
סוג: string | null

סוג הרכיב

server
סוג: string | null

גרסת השרת

size
סוג: integer | null

גודל המשאב: מציין את גודלו של עמוד נתון בבייטים

status_code
סוג: integer | null

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

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

גודל עמוד דחוס: מציין את הגודל הדחוס של עמוד נתון

url
סוג: string | null

כתובת URL של העמוד

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

מספר הפריטים במערך התוצאות

search_after_token
סוג: string | null
total_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

post/v1/beta/dataforseo/on_page/resources

curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/resources \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "id": "07281559-0695-0216-0000-c269be8b7592",
    "filters": [
      [
        "resource_type",
        "=",
        "image"
      ],
      "and",
      [
        "size",
        ">",
        100000
      ]
    ],
    "order_by": [
      "size,desc"
    ],
    "limit": 10
  }
]'

הצגת סכמה

{
  "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
          },
          "search_after_token": null,
          "current_offset": null,
          "total_items_count": null,
          "items_count": null,
          "items": [
            {
              "resource_type": null,
              "status_code": null,
              "location": null,
              "url": null,
              "resource_errors": "[Max Depth Exceeded]",
              "size": null,
              "encoded_size": null,
              "total_transfer_size": null,
              "fetch_time": null,
              "cache_control": "[Max Depth Exceeded]",
              "checks": null,
              "content_encoding": null,
              "media_type": null,
              "server": null,
              "last_modified": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

פעולה מוצלחת

משאבים ב-OnPage API

אימותRequired

DataForSEO

משאבים ב-OnPage API

מראה תמחור