DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
הגדרת משימות OnPage
מתחיל סריקה של target ומחזיר id של משימה ב-tasks[0].id — ה-id הזה הוא הידית שכל כלי אחר במשפחה הזו צריך, אז שמרו אותו. max_crawl_pages מגביל את הסריקה, start_url, max_crawl_depth, priority_urls ו-crawl_delay מעצבים אותה, ו-store_raw_html קובע אם ל-post_dataforseo_on_page_raw_html יהיה מה להגיש אחר כך. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. ⚠️ זה לא צמד השליחה/שליפה הרגיל: הסריקה היא סשן שכלים אחרים שואלים אותו לפי id. סקרו את get_dataforseo_on_page_summary עד ש-crawl_progress קורא finished; סריקה של דף אחד ב-example.com ארכה הרבה פחות מדקה.
מראה תמחור
- מדידה: עלות תגובה מדווחת.
- אומדן בקשת ייחוס: 0.003 דולר ארה״ב.
- מכפיל לקוח לייחוס: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.
זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.
- סוג: array (object | null)[]
- acceptסוג: string | null
_language כותרת שפה לגישה לאתר
שדה אופציונלי
כל פורמטי הלוקאל נתמכים (xx, xx-XX, xxx-XX וכו')
הערה: אם לא מציינים את הפרמטר הזה, אתרים מסוימים עשויים לחסום גישה; במקרה כזה, העמודים יוחזרו עם"type":"brokenבמערך התגובה - allowסוג: boolean | null
_subdomains הכללת עמודים בתת-דומיינים
שדה אופציונלי
הגדירו ל-trueאם ברצונכם לסרוק את כל תת-הדומיינים של אתר יעד
ערך ברירת מחדל:false - allowedסוג: array string[] | null
_subdomains תת-דומיינים לסריקה
שדה אופציונלי
ציינו את תת-הדומיינים שברצונכם לסרוק
דוגמה:["blog.site.com", "my.site.com", "shop.site.com"]
הערה: כדי להשתמש בפרמטר הזה, יש להגדיר את הפרמטרallow_subdomainsל-false;
אחרת, התוכן של השדהallowed_subdomainsיתעלם והתוצאות יוחזרו עבור כל תת-הדומיינים - browserסוג: string | null
_preset הגדרה מראש של פרמטרי מסך הדפדפן
שדה אופציונלי
אם משתמשים בשדה הזה, אין צורך לצייןbrowser_screen_width,browser_screen_height,browser_screen_scale_factorערכים אפשריים:desktop,mobile,tabletההגדרה מראשdesktopתחיל את הערכים הבאים:browser_screen_width: 1920browser_screen_height: 1080browser_screen_scale_factor: 1ההגדרה מראשmobileתחיל את הערכים הבאים:browser_screen_width: 390browser_screen_height: 844browser_screen_scale_factor: 3ההגדרה מראשtabletתחיל את הערכים הבאים:browser_screen_width: 1024browser_screen_height: 1366browser_screen_scale_factor: 2
הערה: כדי להשתמש בפרמטר הזה, הגדירו אתenable_javascriptאוenable_browser_renderingל-true - browserסוג: integer | null
_screen _height גובה מסך הדפדפן
שדה אופציונלי
אפשר להגדיר גובה מסך דפדפן מותאם כדי לבצע ביקורת עבור מכשיר מסוים;
אם משתמשים בשדה הזה, אין צורך לצייןbrowser_presetמכיוון שהוא יתעלם;
הערה: כדי להשתמש בפרמטר הזה, הגדירו אתenable_javascriptאוenable_browser_renderingל-trueהערך המזערי, בפיקסלים:240
הערך המרבי, בפיקסלים:9999 - browserסוג: number | null
_screen _scale _factor מקדם קנה מידה של מסך הדפדפן
שדה אופציונלי
אפשר להגדיר יחס רזולוציית מסך דפדפן מותאם כדי לבצע ביקורת עבור מכשיר מסוים;
אם משתמשים בשדה הזה, אין צורך לצייןbrowser_presetמכיוון שהוא יתעלם;
הערה: כדי להשתמש בפרמטר הזה, הגדירו אתenable_javascriptאוenable_browser_renderingל-trueהערך המזערי:0.5
הערך המרבי:3 - browserסוג: integer | null פורמט: int64
_screen _width רוחב מסך הדפדפן
שדה אופציונלי
אפשר להגדיר רוחב מסך דפדפן מותאם כדי לבצע ביקורת עבור מכשיר מסוים;
אם משתמשים בשדה הזה, אין צורך לצייןbrowser_presetמכיוון שהוא יתעלם;
הערה: כדי להשתמש בפרמטר הזה, הגדירו אתenable_javascriptאוenable_browser_renderingל-trueהערך המזערי, בפיקסלים:240
הערך המרבי, בפיקסלים:9999 - calculateסוג: boolean | null
_keyword _density חישוב צפיפות מילות מפתח עבור הדומיין היעד
שדה אופציונלי
הגדירו ל-trueאם ברצונכם לחשב צפיפות מילות מפתח עבור עמודי האתר
ערך ברירת מחדל:false
הערה: אם משתמשים בפרמטר הזה, יגבו חיובים נוספים; מידע נוסף על עלות משימות עם הפרמטר הזה במאמר העזרה שלנו
לאחר השלמת הסריקה, אפשר לקבל ערכי צפיפות מילות מפתח עם נקודת הקצה Keyword Density - checkסוג: boolean | null
_spell - checkסוג: array string[] | null
_spell _exceptions מילים המוחרגות מבדיקת איות
שדה אופציונלי
ציינו את המילים שברצונכם להחריג מבדיקת איות
אורך מילה מרבי: 100 תווים
מספר מילים מרבי: 1000
דוגמה:"SERP", "minifiers", "JavaScript" - checkסוג: string | null
_spell _language שפת בדיקת האיות
שדה אופציונלי
שפות נתמכות: 'hy', 'eu', 'bg', 'ca', 'hr', 'cs', 'da', 'nl', 'en', 'eo', 'et', 'fo', 'fa', 'fr', 'fy', 'gl', 'ka', 'de', 'el', 'he', 'hu', 'is', 'ia', 'ga', 'it', 'rw', 'la', 'lv', 'lt', 'mk', 'mn', 'ne', 'nb', 'nn', 'pl', 'pt', 'ro', 'gd', 'sr', 'sk', 'sl', 'es', 'sv', 'tr', 'tk', 'uk', 'vi'
הערה: אם לא מציינים שפה, היא תיקבע אוטומטית לפי תוכן העמוד - checksסוג: object | null
_threshold ערכי סף מותאמים לבדיקות
שדה אופציונלי
אפשר לציין ערכי סף מותאמים עבור הפרמטרים הכלולים באובייקטchecksבתגובות OnPage API;
הערה: אפשר לשנות רק ערכי סף שלמים;
לדוגמה, הפרמטריםhigh_loading_timeו-large_page_sizeמוגדרים כברירת מחדל ל-3 שניות ול-1 מגה-בייט בהתאמה;
אם ברצונכם לשנות את ערכי הסף האלה ל-1 שנייה ול-1000 קילובייט, השתמשו בקטע הבא:"checks_threshold": {<br>"high_loading_time": 1,<br>"large_page_size": 1000<br>}
פרמטרים הניתנים להתאמה עם ערכי ברירת המחדל שלהם:"title_too_short", default value: 30, type: "int"<br>"title_too_long", default value: 65, type: "int"<br>"small_page_size", default value: 1024, type: "int"<br>"large_page_size", default value: 1048576 (1024 * 1024), type: "int"<br>"low_character_count", default value: 1024, type: "int"<br>"high_character_count", default value: 256000 (250 * 1024), type: "int"<br>"low_content_rate", default value: 0.1, type: "float"<br>"high_content_rate", default value: 0.9, type: "float"<br>"high_loading_time", default value: 3000, type: "int"<br>"high_waiting_time", default value: 1500, type: "int"<br>"low_readability_rate", default value: 15.0, type: "float"<br>"irrelevant_description", default value: 0.2, type: "float"<br>"irrelevant_title", default value: 0.3, type: "float"<br>"irrelevant_meta_keywords", default value: 0.6, type: "float"- propertyסוג: integer | null פורמט: int64
Name Signed 64-bit integers (long type).
- crawlסוג: integer | null
_delay השהיה בין בקשות, במילישניות
שדה אופציונלי
ההשהיה המותאמת אישית בין בקשות הסורק לשרת
ערך ברירת מחדל:2000 - crawlסוג: boolean | null
_sitemap _only סריקת עמודים שמצוינים ב-sitemap בלבד
שדה אופציונלי
הגדירו ל-trueאם ברצונכם לסרוק רק את העמודים שמצוינים ב-sitemap
אם תגדירו את הפרמטר הזה ל-trueולא תציינוcustom_sitemap, נסרוק את ה-sitemap המוגדר כברירת מחדל
ערך ברירת מחדל:false
הערה: כדי להשתמש בפרמטר הזה,respect_sitemapצריך להיותtrue - customסוג: string | null
_js JavaScript מותאם אישית
שדה אופציונלי
שימו לב שזמן ההרצה של הסקריפט שתזינו כאן צריך להיות 700 מ"ש לכל היותר, לדוגמה, אפשר להשתמש במקטע ה-JS הבא כדי לבדוק אם האתר מכיל Google Tag Manager כמאפייןscr:let meta = { haveGoogleAnalytics: false, haveTagManager: false };rnfor (var i = 0; i < document.scripts.length; i++) {rn let src = document.scripts[i].getAttribute("src");rn if (src != undefined) {rn if (src.indexOf("analytics.js") >= 0)rn meta.haveGoogleAnalytics = true;rntif (src.indexOf("gtm.js") >= 0)rn meta.haveTagManager = true;rn }rn}rnmeta;הערך המוחזר תלוי במה שציינתם בשדה הזה. לדוגמה, אם תציינו את הסקריפט הבא:meta = {}; meta.url = document.URL; meta.test = 'test'; meta;
כתגובה תקבלו את הנתונים הבאים:"custom_js_response": {<br>"url": "https://dataforseo.com/",<br>"test": "test"<br>}
הערה: אורך הסקריפט שתזינו לא יעלה על 2000 תווים - customסוג: string | null
_robots _txt הגדרות robots.txt מותאמות אישית
שדה אופציונלי
דוגמה:Disallow: /directory1/ - customסוג: string | null
_sitemap כתובת URL מותאמת אישית של sitemap
שדה אופציונלי
כתובת ה-URL של העמוד שבו נמצא ה-sitemap החלופי
הערה: כדי להשתמש בפרמטר הזה,respect_sitemapצריך להיותtrue - customסוג: string | null
_user _agent user agent מותאם אישית
שדה אופציונלי
user agent מותאם אישית לסריקת אתר
דוגמה:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36
ערך ברירת מחדל:Mozilla/5.0 (compatible; RSiteAuditor) - disableסוג: boolean | null
_cookie _popup השבתת חלון הקופצים של קובצי Cookie
שדה אופציונלי
הגדירו ל-trueאם ברצונכם להשבית את החלון הקופץ שמבקש מהמשתמש הסכמה לשימוש בקובצי Cookie;
ערך ברירת מחדל:false - disableסוג: array string[] | null
_page _checks מניעת הרצה של בדיקות עמוד מסוימות
שדה אופציונלי
ציינוchecksמסוימות כדי למנוע מהן לרוץ ולהשפיע עלonpage_scoreדוגמה:"disable_page_checks": ["is_5xx_code", "is_4xx_code"] - disableסוג: array string[] | null
_sitewide _checks מניעת הרצה של בדיקות sitewide מסוימות
שדה אופציונלי
ציינו אתchecksהבאות כדי למנוע מהן לרוץ באתרtarget:"test_page_not_found""test_canonicalization""test_https_redirect""test_directory_browsing"דוגמה:"disable_sitewide_checks": ["test_directory_browsing", "test_page_not_found"]מידע נוסף במרכז העזרה שלנו - disallowedסוג: array string[] | null
_subdomains תת-דומיינים שאין לסרוק
שדה אופציונלי
ציינו תת-דומיינים שאין ברצונכם לסרוק
דוגמה:["status.site.com", "docs.site.com"]
הערה: כדי להשתמש בפרמטר הזה, יש להגדיר את הפרמטרallow_subdomainsל-true - enableסוג: boolean | null
_browser _rendering הדמיית רינדור דפדפן למדידת Core Web Vitals
שדה אופציונלי
באמצעות הפרמטר הזה תוכלו להדמות דפדפן בעת טעינת עמוד אינטרנט;enable_browser_renderingטוען סגנונות, תמונות, גופנים, אנימציות, סרטונים ומשאבים אחרים בעמוד;
ערך ברירת מחדל:false
הגדירו ל-trueכדי לקבל מדדי Core Web Vitals (FID, CLS, LCP) בתגובה;
אם תשתמשו בשדה הזה, יש להגדיר את הפרמטריםenable_javascriptו-load_resourcesל-true
הערה: אם תשתמשו בפרמטר הזה, יחולו חיובים נוספים; מידע נוסף על עלות משימות עם הפרמטר הזה במאמר העזרה שלנו; אפשר לחשב את העלות בעמוד התמחור - enableסוג: boolean | null
_content _parsing - enableסוג: boolean | null
_javascript - enableסוג: boolean | null
_www _redirect _check בדיקה אם הדומיין הטמיע הפניית www
שדה אופציונלי
הגדירו ל-trueאם ברצונכם לבדוק אם הדומיין המבוקש הטמיע הפנייה מ-www ל-non-www או מ-non-www ל-www;
ערך ברירת מחדל:false - enableסוג: boolean | null
_xhr הפעלת XMLHttpRequest בעמוד
שדה אופציונלי
הגדירו ל-trueאם ברצונכם שהסורק שלנו יבקש נתונים משרת אינטרנט באמצעות אובייקט XMLHttpRequest
ערך ברירת מחדל:false;אם תשתמשו בשדה הזה, יש להגדיר אתenable_javascriptל-true; - forceסוג: boolean | null
_sitewide _checks הפעלת בדיקות sitewide בעת סריקת עמוד בודד
שדה אופציונלי
הגדירו ל-trueכדי לקבל נתונים על בדיקות sitewide בעת סריקת עמוד בודד;
ערך ברירת מחדל:false - loadסוג: boolean | null
_resources - maxסוג: integer | null
_crawl _depth עומק סריקה
שדה אופציונלי
עומק הקישור של העמודים לסריקה;
לדוגמה, עמוד ההתחלה של הסריקה הוא רמה 0, עמודים שיש להם קישורים מהעמוד הזה הם רמה 1, וכן הלאה. - maxסוג: integer
_crawl _pages מגבלת עמודים לסריקה
שדה חובה
מספר העמודים לסריקה בדומיין שצוין
הערה:
אם תגדירו אתmax_crawl_pagesל-1 ולא תציינוstart_urlאו תגדירו בו עמוד בית, הבדיקות ה-sitewide הבאות יושבתו:test_canonicalization,enable_www_redirect_check,test_hidden_server_signature,test_page_not_found,test_directory_browsing,test_https_redirect
כדי להפעיל אותן בכל זאת, הגדירו אתforce_sitewide_checksל-trueאם תגדירו אתmax_crawl_pagesל-1 ותציינוstart_urlשאינו עמוד בית, כל הבדיקות ה-sitewide יושבתו;
כדי להפעיל אותן בכל זאת, הגדירו אתforce_sitewide_checksל-true - pingbackסוג: string | null
_url כתובת URL להתראה על השלמת משימה
שדה אופציונלי
כשהמשימה תושלם, נודיע לכם באמצעות בקשת GET שתישלח לכתובת ה-URL שציינתם
אפשר להשתמש במחרוזת ‘$id’ כמשתנה$idוב-‘$tag’ כמשתנה$tagמקודד ב-urlencoded. נעדכן את הערכים הנדרשים לפני שליחת הבקשה.
דוגמה:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
הערה: תווים מיוחדים ב-pingback_urlיקודדו ב-urlencoded;
לדוגמה, התו#יקודד ל-%23 - priorityסוג: array string[] | null
_urls כתובות URL לסריקה תוך עקיפת התור
שדה אופציונלי
כתובות ה-URL שצוינו במערך הזה ייסרקו ראשונות, תוך עקיפת תור הסריקה;
הערה: יש לציין כתובת URL מוחלטת;
אפשר לציין עד 20 כתובות URL;
כל כתובות ה-URL במערך חייבות להשתייך לדומייןtarget;
תת-דומיינים ייתעלמו אלא אם הפרמטרallow_subdomainsמוגדר ל-trueדוגמה:"priority_urls": [<br>"https://dataforseo.com/apis/serp-api",<br>"https://dataforseo.com/contact"<br>] - respectסוג: boolean | null
_sitemap כיבוד sitemap בעת הסריקה
שדה אופציונלי
הגדירו ל-trueאם ברצונכם לפעול לפי סדר העמודים שמצוינים ב-sitemap הראשי בעת הסריקה;
ערך ברירת מחדל:false
הערה: אם מוגדר ל-true, הערךclick_depthבתגובת ה-API יהיה0;
השדהmax_crawl_depthשל הבקשה יתעלם ממנו, ואפשר לציין את מספר העמודים לסריקה באמצעות הפרמטרmax_crawl_pages - returnסוג: boolean | null
_despite _timeout החזרת נתונים על עמודים למרות שגיאת פסק זמן
שדה אופציונלי
אםtrue, הנתונים יסופקו עבור עמודים שלא נטענו בתוך 120 שניות והחזירו שגיאת פסק זמן;
ערך ברירת מחדל:false - robotsסוג: string | null
_txt _merge _mode מיזוג או עקיפת הגדרות robots.txt
שדה אופציונלי
ערכים אפשריים:merge,override;
הגדירו ל-overrideאם ברצונכם להתעלם ממגבלות הסריקה של האתר ומהגדרות robots.txt אחרות
ערך ברירת מחדל:merge;
הערה: אם מוגדר ל-override, ציינו את הפרמטרcustom_robots_txt - startסוג: string | null
_url - storeסוג: boolean | null
_raw _html - supportסוג: boolean | null
_cookies תמיכה בקובצי Cookie בעמודים שנסרקו
שדה אופציונלי
הגדירו ל-trueכדי לתמוך בקובצי Cookie בעת סריקת העמודים
ערך ברירת מחדל:false - switchסוג: boolean | null
_pool החלפת מאגר פרוקסי
שדה אופציונלי
אם הערךtrue, ישתמשו במאגרי פרוקסי נוספים להשגת הנתונים המבוקשים;
אפשר להשתמש בפרמטר אם מגדירים כמות גדולה של משימות בו-זמנית, מה שגורם לשגיאותrate-limitו/אוsite_unreachableמדי פעם - tagסוג: string | null
מזהה משימה מוגדר על ידי המשתמש
שדה אופציונלי
מגבלת התווים היא 255
אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
את ערך ה-tagשציינתם תמצאו באובייקטdataשל התגובה - targetסוג: string
דומיין יעד
שדה חובה
יש לציין את שם הדומיין בליhttps://ובליwww.
אם תציינו כתובת URL של עמוד, התוצאות יוחזרו עבור הדומיין שנכלל בכתובת ה-URL - validateסוג: boolean | null
_micromarkup
- סוג: object | null · Response36Afe1097B20_OnPageTaskPostResponseInfo200
- סוג: number | null פורמט: doublecost
סך עלות המשימות, בדולר ארה״ב
- סוג: integer | nullstatus
_code קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- סוג: string | nullstatus
_message הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- סוג: array (object | null)[] | nulltasks
מערך משימות
- סוג: object | null · Response36Afe1097B20_OnPageTaskPostTaskInfo
- costסוג: number | null פורמט: double
סך עלות המשימות, בדולר ארה״ב
- dataסוג: object | null
מכיל את אותם הפרמטרים שציינתם בבקשת POST
- propertyסוג: object | null
Name
- idסוג: string | null
מזהה משימה מזהה משימה ייחודי במערכת שלנו בפורמט UUID
- pathסוג: array (string | null)[] | null
נתיב URL
- resultסוג: object | null
מערך תוצאות
במקרה זה, הערך יהיהnull - resultסוג: integer | null פורמט: int64
_count מספר הפריטים במערך result
- statusסוג: integer | null
_code קוד הסטטוס של המשימה נוצר על ידי DataForSEO ויכול להיות בטווח הבא: 10000-60000 את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- statusסוג: string | null
_message הודעה אינפורמטיבית של המשימה את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- timeסוג: string | null
זמן ביצוע, בשניות
- סוג: integer | null פורמט: int64tasks
_count מספר המשימות במערך tasks
- סוג: integer | null פורמט: int64tasks
_error מספר המשימות במערך tasks שהוחזרו עם שגיאה
- סוג: string | nulltime
זמן ביצוע כולל, בשניות
- סוג: string | nullversion
הגרסה הנוכחית של ה-API
application/json - 400
לא ניתן היה לעבד את הבקשה. בדקו את פרמטרי הבקשה.
- 401
נדרש מפתח API תקף של Felo.
- 402
לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.
- 403
החשבון אינו מורשה לבצע את הפעולה הזו.
- 429
הגעתם למגבלת בקשות או לתקרת הוצאה.
- 502
השירות לא הצליח להשלים את הבקשה.
- 503
שירות ה-API או החיוב אינו זמין באופן זמני.
- 504
השירות פג בזמן הטיפול בבקשה.
- default
תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "dataforseo.com",
"max_crawl_pages": 10,
"load_resources": true,
"enable_javascript": true,
"custom_js": "meta = {}; meta.url = document.URL; meta;",
"tag": "some_string_123",
"pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
}
]'
{
"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": null
}
]
}