# הגדרת משימות OnPage

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/on_page/task_post`

**Tags:** DataForSEO

מתחיל סריקה של `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.

## Related links

- [נקודת הקצה Instant Pages החיה](<https://docs.dataforseo.com/v3/on_page/instant_pages/?bash>)
- [נקודת הקצה OnPage Raw HTML](<https://docs.dataforseo.com/v3/on_page/raw_html/>)
- [נקודת הקצה OnPage Content Parsing](<https://docs.dataforseo.com/v3/on_page/content_parsing/live/>)
- [במאמר העזרה](<https://dataforseo.com/help-center/cost-of-onpage-api-parameters>)
- [עמוד התמחור](<https://dataforseo.com/pricing/on-page/onpage-api>)
- [נקודת הקצה Microdata של OnPage API](<https://docs.dataforseo.com/v3/on_page/microdata/>)
- [Hunspell](<http://hunspell.github.io/>)
- [נקודת הקצה Keyword Density](<https://docs.dataforseo.com/v3/on_page/keyword_density?bash>)
- [מרכז העזרה](<https://dataforseo.com/help-center/how-to-disable-sitewide-checks-in-onpage-api>)
- [מרכז העזרה](<https://dataforseo.com/help-center/pingbacks-postbacks-with-dataforseo-api>)

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "target": {
            "type": "string",
            "description": "<em>דומיין יעד</em><br><strong>שדה חובה</strong><br>יש לציין את שם הדומיין בלי <code>https://</code> ובלי <code>www.</code><br>אם תציינו כתובת URL של עמוד, התוצאות יוחזרו עבור הדומיין שנכלל בכתובת ה-URL"
          },
          "max_crawl_pages": {
            "type": "integer",
            "description": "<em>מגבלת עמודים לסריקה</em><br><strong>שדה חובה</strong><br>מספר העמודים לסריקה בדומיין שצוין<br><strong>הערה:</strong><br>אם תגדירו את <code>max_crawl_pages</code> ל-1 ולא תציינו <code>start_url</code> או תגדירו בו עמוד בית, הבדיקות ה-sitewide הבאות יושבתו:<br><code>test_canonicalization</code>, <code>enable_www_redirect_check</code>, <code>test_hidden_server_signature</code>, <code>test_page_not_found</code>, <code>test_directory_browsing</code>, <code>test_https_redirect</code><br>כדי להפעיל אותן בכל זאת, הגדירו את <code>force_sitewide_checks</code> ל-<code>true</code>אם תגדירו את <code>max_crawl_pages</code> ל-1 ותציינו <code>start_url</code> שאינו עמוד בית, כל הבדיקות ה-sitewide יושבתו;<br>כדי להפעיל אותן בכל זאת, הגדירו את <code>force_sitewide_checks</code> ל-<code>true</code>"
          },
          "start_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>כתובת ה-URL הראשונה לסריקה </em><br>שדה אופציונלי<br><strong>הערה:</strong> יש לציין כתובת URL מוחלטת<br>אם ברצונכם לסרוק עמוד בודד, ציינו את כתובת ה-URL שלו בשדה הזה ובנוסף הגדירו את הפרמטר <code>max_crawl_pages</code> ל-<code>1</code><br>אפשר גם להשתמש בנקודת הקצה Instant Pages החיה כדי לקבל נתונים ספציפיים לעמוד"
          },
          "force_sitewide_checks": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>הפעלת בדיקות sitewide בעת סריקת עמוד בודד</em><br>שדה אופציונלי<br>הגדירו ל-<code>true</code> כדי לקבל נתונים על בדיקות sitewide בעת סריקת עמוד בודד;<br>ערך ברירת מחדל: <code>false</code>"
          },
          "priority_urls": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>כתובות URL לסריקה תוך עקיפת התור</em><br>שדה אופציונלי<br>כתובות ה-URL שצוינו במערך הזה ייסרקו ראשונות, תוך עקיפת תור הסריקה;<br><strong>הערה:</strong> יש לציין כתובת URL מוחלטת;<br>אפשר לציין עד <strong>20 כתובות URL</strong>;<br>כל כתובות ה-URL במערך חייבות להשתייך לדומיין <code>target</code>;<br>תת-דומיינים ייתעלמו אלא אם הפרמטר <code>allow_subdomains</code> מוגדר ל-<code>true</code>דוגמה:<br>`\"priority_urls\": [<br>\"https://dataforseo.com/apis/serp-api\",<br>\"https://dataforseo.com/contact\"<br>]`"
          },
          "max_crawl_depth": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>עומק סריקה</em><br>שדה אופציונלי<br>עומק הקישור של העמודים לסריקה;<br>לדוגמה, עמוד ההתחלה של הסריקה הוא רמה 0, עמודים שיש להם קישורים מהעמוד הזה הם רמה 1, וכן הלאה."
          },
          "crawl_delay": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>השהיה בין בקשות, במילישניות</em><br>שדה אופציונלי<br>ההשהיה המותאמת אישית בין בקשות הסורק לשרת<br>ערך ברירת מחדל: <code>2000</code>"
          },
          "store_raw_html": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>שמירת HTML של עמודים שנסרקו</em><br>שדה אופציונלי<br>הגדירו ל-<code>true</code> אם ברצונכם לקבל את ה-HTML של העמוד באמצעות נקודת הקצה OnPage Raw HTML<br>ערך ברירת מחדל: <code>false</code>"
          },
          "enable_content_parsing": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>פענוח תוכן בעמודים שנסרקו</em><br>שדה אופציונלי<br>הגדירו ל-<code>true</code> כדי להשתמש בנקודת הקצה OnPage Content Parsing<br>ערך ברירת מחדל: <code>false</code>"
          },
          "support_cookies": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>תמיכה בקובצי Cookie בעמודים שנסרקו</em><br>שדה אופציונלי<br>הגדירו ל-<code>true</code> כדי לתמוך בקובצי Cookie בעת סריקת העמודים<br>ערך ברירת מחדל: <code>false</code>"
          },
          "accept_language": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>כותרת שפה לגישה לאתר</em><br>שדה אופציונלי<br>כל פורמטי הלוקאל נתמכים (xx, xx-XX, xxx-XX וכו')<br><strong>הערה:</strong> אם לא מציינים את הפרמטר הזה, אתרים מסוימים עשויים לחסום גישה; במקרה כזה, העמודים יוחזרו עם <code>\"type\":\"broken</code> במערך התגובה"
          },
          "custom_robots_txt": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>הגדרות robots.txt מותאמות אישית</em><br>שדה אופציונלי<br>דוגמה: <code>Disallow: /directory1/</code>"
          },
          "robots_txt_merge_mode": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>מיזוג או עקיפת הגדרות robots.txt</em><br>שדה אופציונלי<br>ערכים אפשריים: <code>merge</code>, <code>override</code>;<br>הגדירו ל-<code>override</code> אם ברצונכם להתעלם ממגבלות הסריקה של האתר ומהגדרות robots.txt אחרות<br>ערך ברירת מחדל: <code>merge</code>;<br><strong>הערה:</strong> אם מוגדר ל-<code>override</code>, ציינו את הפרמטר <code>custom_robots_txt</code>"
          },
          "custom_user_agent": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>user agent מותאם אישית</em><br>שדה אופציונלי<br>user agent מותאם אישית לסריקת אתר<br>דוגמה: <code>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<br></code><br>ערך ברירת מחדל: <code>Mozilla/5.0 (compatible; RSiteAuditor)</code>"
          },
          "browser_preset": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>הגדרה מראש של פרמטרי מסך הדפדפן</em><br>שדה אופציונלי<br>אם משתמשים בשדה הזה, אין צורך לציין <code>browser_screen_width</code>, <code>browser_screen_height</code>, <code>browser_screen_scale_factor</code> ערכים אפשריים:<br><code>desktop</code>, <code>mobile</code>, <code>tablet</code> ההגדרה מראש <code>desktop</code> תחיל את הערכים הבאים:<code>browser_screen_width: 1920</code><br><code>browser_screen_height: 1080</code><br><code>browser_screen_scale_factor: 1</code> ההגדרה מראש <code>mobile</code> תחיל את הערכים הבאים:<code>browser_screen_width: 390</code><br><code>browser_screen_height: 844</code><br><code>browser_screen_scale_factor: 3</code> ההגדרה מראש <code>tablet</code> תחיל את הערכים הבאים:<code>browser_screen_width: 1024</code><br><code>browser_screen_height: 1366</code><br><code>browser_screen_scale_factor: 2</code><br><strong>הערה:</strong> כדי להשתמש בפרמטר הזה, הגדירו את <code>enable_javascript</code> או <code>enable_browser_rendering</code> ל-<code>true</code>"
          },
          "browser_screen_width": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>רוחב מסך הדפדפן</em><br>שדה אופציונלי<br>אפשר להגדיר רוחב מסך דפדפן מותאם כדי לבצע ביקורת עבור מכשיר מסוים;<br>אם משתמשים בשדה הזה, אין צורך לציין <code>browser_preset</code> מכיוון שהוא יתעלם;<br><strong>הערה:</strong> כדי להשתמש בפרמטר הזה, הגדירו את <code>enable_javascript</code> או <code>enable_browser_rendering</code> ל-<code>true</code> הערך המזערי, בפיקסלים: <code>240</code><br>הערך המרבי, בפיקסלים: <code>9999</code>",
            "format": "int64"
          },
          "browser_screen_height": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>גובה מסך הדפדפן</em><br>שדה אופציונלי<br>אפשר להגדיר גובה מסך דפדפן מותאם כדי לבצע ביקורת עבור מכשיר מסוים;<br>אם משתמשים בשדה הזה, אין צורך לציין <code>browser_preset</code> מכיוון שהוא יתעלם;<br><strong>הערה:</strong> כדי להשתמש בפרמטר הזה, הגדירו את <code>enable_javascript</code> או <code>enable_browser_rendering</code> ל-<code>true</code> הערך המזערי, בפיקסלים: <code>240</code><br>הערך המרבי, בפיקסלים: <code>9999</code>"
          },
          "browser_screen_scale_factor": {
            "type": [
              "number",
              "null"
            ],
            "description": "<em>מקדם קנה מידה של מסך הדפדפן</em><br>שדה אופציונלי<br>אפשר להגדיר יחס רזולוציית מסך דפדפן מותאם כדי לבצע ביקורת עבור מכשיר מסוים;<br>אם משתמשים בשדה הזה, אין צורך לציין <code>browser_preset</code> מכיוון שהוא יתעלם;<br><strong>הערה:</strong> כדי להשתמש בפרמטר הזה, הגדירו את <code>enable_javascript</code> או <code>enable_browser_rendering</code> ל-<code>true</code> הערך המזערי: <code>0.5</code><br>הערך המרבי: <code>3</code>"
          },
          "respect_sitemap": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>כיבוד sitemap בעת הסריקה</em><br>שדה אופציונלי<br>הגדירו ל-<code>true</code> אם ברצונכם לפעול לפי סדר העמודים שמצוינים ב-sitemap הראשי בעת הסריקה;<br>ערך ברירת מחדל: <code>false</code><br><strong>הערה:</strong> אם מוגדר ל-<code>true</code>, הערך <code>click_depth</code> בתגובת ה-API יהיה <code>0</code>;<br>השדה <code>max_crawl_depth</code> של הבקשה יתעלם ממנו, ואפשר לציין את מספר העמודים לסריקה באמצעות הפרמטר <code>max_crawl_pages</code>"
          },
          "custom_sitemap": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>כתובת URL מותאמת אישית של sitemap</em><br>שדה אופציונלי<br>כתובת ה-URL של העמוד שבו נמצא ה-sitemap החלופי<br><strong>הערה:</strong> כדי להשתמש בפרמטר הזה, <code>respect_sitemap</code> צריך להיות <code>true</code>"
          },
          "crawl_sitemap_only": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>סריקת עמודים שמצוינים ב-sitemap בלבד</em><br>שדה אופציונלי<br>הגדירו ל-<code>true</code> אם ברצונכם לסרוק רק את העמודים שמצוינים ב-sitemap<br>אם תגדירו את הפרמטר הזה ל-<code>true</code> ולא תציינו <code>custom_sitemap</code>, נסרוק את ה-sitemap המוגדר כברירת מחדל<br>ערך ברירת מחדל: <code>false</code><br><strong>הערה:</strong> כדי להשתמש בפרמטר הזה, <code>respect_sitemap</code> צריך להיות <code>true</code>"
          },
          "load_resources": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>טעינת משאבים</em><br>שדה אופציונלי<br>הגדירו ל-<code>true</code> אם ברצונכם לטעון תמונות, גיליונות סגנון, סקריפטים ומשאבים שבורים<br>ערך ברירת מחדל: <code>false</code><br><strong>הערה:</strong> אם תשתמשו בפרמטר הזה, יחולו חיובים נוספים; מידע נוסף על עלות משימות עם הפרמטר הזה במאמר העזרה שלנו; אפשר לחשב את העלות בעמוד התמחור"
          },
          "enable_www_redirect_check": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>בדיקה אם הדומיין הטמיע הפניית www</em><br>שדה אופציונלי<br>הגדירו ל-<code>true</code> אם ברצונכם לבדוק אם הדומיין המבוקש הטמיע הפנייה מ-www ל-non-www או מ-non-www ל-www;<br>ערך ברירת מחדל: <code>false</code>"
          },
          "enable_javascript": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>טעינת JavaScript בעמוד</em><br>שדה אופציונלי<br>הגדירו ל-<code>true</code> אם ברצונכם לטעון את הסקריפטים הזמינים בעמוד<br>ערך ברירת מחדל: <code>false</code><br><strong>הערה:</strong> אם תשתמשו בפרמטר הזה, יחולו חיובים נוספים; מידע נוסף על עלות משימות עם הפרמטר הזה במאמר העזרה שלנו; אפשר לחשב את העלות בעמוד התמחור"
          },
          "enable_xhr": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>הפעלת XMLHttpRequest בעמוד</em><br>שדה אופציונלי<br>הגדירו ל-<code>true</code> אם ברצונכם שהסורק שלנו יבקש נתונים משרת אינטרנט באמצעות אובייקט XMLHttpRequest<br>ערך ברירת מחדל: <code>false</code>;אם תשתמשו בשדה הזה, יש להגדיר את <code>enable_javascript</code> ל-<code>true</code>;"
          },
          "enable_browser_rendering": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>הדמיית רינדור דפדפן למדידת Core Web Vitals</em><br>שדה אופציונלי<br>באמצעות הפרמטר הזה תוכלו להדמות דפדפן בעת טעינת עמוד אינטרנט;<br><code>enable_browser_rendering</code> טוען סגנונות, תמונות, גופנים, אנימציות, סרטונים ומשאבים אחרים בעמוד;<br>ערך ברירת מחדל: <code>false</code><br>הגדירו ל-<code>true</code> כדי לקבל מדדי Core Web Vitals (FID, CLS, LCP) בתגובה;<br><strong>אם תשתמשו בשדה הזה, יש להגדיר את הפרמטרים <code>enable_javascript</code> ו-<code>load_resources</code> ל-<code>true</code></strong><br><strong>הערה:</strong> אם תשתמשו בפרמטר הזה, יחולו חיובים נוספים; מידע נוסף על עלות משימות עם הפרמטר הזה במאמר העזרה שלנו; אפשר לחשב את העלות בעמוד התמחור"
          },
          "disable_cookie_popup": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>השבתת חלון הקופצים של קובצי Cookie</em><br>שדה אופציונלי<br>הגדירו ל-<code>true</code> אם ברצונכם להשבית את החלון הקופץ שמבקש מהמשתמש הסכמה לשימוש בקובצי Cookie;<br>ערך ברירת מחדל:<br><code>false</code>"
          },
          "custom_js": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>JavaScript מותאם אישית</em><br>שדה אופציונלי<br><strong>שימו לב</strong> שזמן ההרצה של הסקריפט שתזינו כאן צריך להיות 700 מ\"ש לכל היותר, לדוגמה, אפשר להשתמש במקטע ה-JS הבא כדי לבדוק אם האתר מכיל Google Tag Manager כמאפיין <code>scr</code>:<br><code>let meta = { haveGoogleAnalytics: false, haveTagManager: false };rnfor (var i = 0; i &lt; document.scripts.length; i++) {rn let src = document.scripts[i].getAttribute(\"src\");rn if (src != undefined) {rn if (src.indexOf(\"analytics.js\") &gt;= 0)rn      meta.haveGoogleAnalytics = true;rntif (src.indexOf(\"gtm.js\") &gt;= 0)rn      meta.haveTagManager = true;rn  }rn}rnmeta;</code>הערך המוחזר תלוי במה שציינתם בשדה הזה. לדוגמה, אם תציינו את הסקריפט הבא:<br>`meta = {}; meta.url = document.URL; meta.test = 'test'; meta;`<br>כתגובה תקבלו את הנתונים הבאים:<br>`\"custom_js_response\": {<br>\"url\": \"https://dataforseo.com/\",<br>\"test\": \"test\"<br>}`<br><strong>הערה:</strong> אורך הסקריפט שתזינו לא יעלה על 2000 תווים"
          },
          "validate_micromarkup": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>הפעלת אימות microdata</em><br>שדה אופציונלי<br>הגדירו ל-<code>true</code> אם ברצונכם להשתמש בנקודת הקצה Microdata של OnPage API<br>ערך ברירת מחדל: <code>false</code>"
          },
          "allow_subdomains": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>הכללת עמודים בתת-דומיינים</em><br>שדה אופציונלי<br>הגדירו ל-<code>true</code> אם ברצונכם לסרוק את כל תת-הדומיינים של אתר יעד<br>ערך ברירת מחדל: <code>false</code>"
          },
          "allowed_subdomains": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>תת-דומיינים לסריקה</em><br>שדה אופציונלי<br>ציינו את תת-הדומיינים שברצונכם לסרוק<br>דוגמה: <code>[\"blog.site.com\", \"my.site.com\", \"shop.site.com\"]</code><br><strong>הערה:</strong> כדי להשתמש בפרמטר הזה, יש להגדיר את הפרמטר <code>allow_subdomains</code> ל-<code>false</code>;<br>אחרת, התוכן של השדה <code>allowed_subdomains</code> יתעלם והתוצאות יוחזרו עבור כל תת-הדומיינים"
          },
          "disallowed_subdomains": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>תת-דומיינים שאין לסרוק</em><br>שדה אופציונלי<br>ציינו תת-דומיינים שאין ברצונכם לסרוק<br>דוגמה: <code>[\"status.site.com\", \"docs.site.com\"]</code><br><strong>הערה:</strong> כדי להשתמש בפרמטר הזה, יש להגדיר את הפרמטר <code>allow_subdomains</code> ל-<code>true</code>"
          },
          "check_spell": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>בדיקת איות</em><br>שדה אופציונלי<br>הגדירו ל-<code>true</code> כדי לבדוק איות באתר באמצעות ספריית Hunspell<br>ערך ברירת מחדל: <code>false</code>"
          },
          "check_spell_language": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>שפת בדיקת האיות</em><br>שדה אופציונלי<br>שפות נתמכות: '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'<br><strong>הערה:</strong> אם לא מציינים שפה, היא תיקבע אוטומטית לפי תוכן העמוד"
          },
          "check_spell_exceptions": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>מילים המוחרגות מבדיקת איות</em><br>שדה אופציונלי<br>ציינו את המילים שברצונכם להחריג מבדיקת איות<br>אורך מילה מרבי: 100 תווים<br>מספר מילים מרבי: 1000<br>דוגמה: <code>\"SERP\", \"minifiers\", \"JavaScript\"</code>"
          },
          "calculate_keyword_density": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>חישוב צפיפות מילות מפתח עבור הדומיין היעד</em><br>שדה אופציונלי<br>הגדירו ל-<code>true</code> אם ברצונכם לחשב צפיפות מילות מפתח עבור עמודי האתר<br>ערך ברירת מחדל: <code>false</code><br><strong>הערה:</strong> אם משתמשים בפרמטר הזה, יגבו חיובים נוספים; מידע נוסף על עלות משימות עם הפרמטר הזה במאמר העזרה שלנו<br>לאחר השלמת הסריקה, אפשר לקבל ערכי צפיפות מילות מפתח עם נקודת הקצה Keyword Density"
          },
          "checks_threshold": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": {
              "type": [
                "integer",
                "null"
              ],
              "format": "int64"
            },
            "description": "<em>ערכי סף מותאמים לבדיקות</em><br>שדה אופציונלי<br>אפשר לציין ערכי סף מותאמים עבור הפרמטרים הכלולים באובייקט <code>checks</code> בתגובות OnPage API;<br><strong>הערה:</strong> אפשר לשנות רק ערכי סף שלמים;<br>לדוגמה, הפרמטרים <code>high_loading_time</code> ו-<code>large_page_size</code> מוגדרים כברירת מחדל ל-3 שניות ול-1 מגה-בייט בהתאמה;<br>אם ברצונכם לשנות את ערכי הסף האלה ל-1 שנייה ול-1000 קילובייט, השתמשו בקטע הבא:<br>`\"checks_threshold\": {<br>\"high_loading_time\": 1,<br>\"large_page_size\": 1000<br>}`<br>פרמטרים הניתנים להתאמה עם ערכי ברירת המחדל שלהם:<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\"`"
          },
          "disable_sitewide_checks": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>מניעת הרצה של בדיקות sitewide מסוימות</em><br>שדה אופציונלי<br>ציינו את <code>checks</code> הבאות כדי למנוע מהן לרוץ באתר <code>target</code>:<br><code>\"test_page_not_found\"</code><br><code>\"test_canonicalization\"</code><br><code>\"test_https_redirect\"</code><br><code>\"test_directory_browsing\"</code>דוגמה:<br><code>\"disable_sitewide_checks\": [\"test_directory_browsing\", \"test_page_not_found\"]</code>מידע נוסף במרכז העזרה שלנו"
          },
          "disable_page_checks": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>מניעת הרצה של בדיקות עמוד מסוימות</em><br>שדה אופציונלי<br>ציינו <code>checks</code> מסוימות כדי למנוע מהן לרוץ ולהשפיע על <code>onpage_score</code>דוגמה:<br><code>\"disable_page_checks\": [\"is_5xx_code\", \"is_4xx_code\"]</code>"
          },
          "switch_pool": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>החלפת מאגר פרוקסי</em><br>שדה אופציונלי<br>אם הערך <code>true</code>, ישתמשו במאגרי פרוקסי נוספים להשגת הנתונים המבוקשים;<br>אפשר להשתמש בפרמטר אם מגדירים כמות גדולה של משימות בו-זמנית, מה שגורם לשגיאות <code>rate-limit</code> ו/או <code>site_unreachable</code> מדי פעם"
          },
          "return_despite_timeout": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>החזרת נתונים על עמודים למרות שגיאת פסק זמן</em><br>שדה אופציונלי<br>אם <code>true</code>, הנתונים יסופקו עבור עמודים שלא נטענו בתוך 120 שניות והחזירו שגיאת פסק זמן;<br>ערך ברירת מחדל: <code>false</code>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>מזהה משימה מוגדר על ידי המשתמש</em><br>שדה אופציונלי<br><em>מגבלת התווים היא 255</em><br>אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה<br>את ערך ה-<code>tag</code> שציינתם תמצאו באובייקט <code>data</code> של התגובה"
          },
          "pingback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>כתובת URL להתראה על השלמת משימה</em><br>שדה אופציונלי<br>כשהמשימה תושלם, נודיע לכם באמצעות בקשת GET שתישלח לכתובת ה-URL שציינתם<br>אפשר להשתמש במחרוזת ‘$id’ כמשתנה <code>$id</code> וב-‘$tag’ כמשתנה <code>$tag</code> מקודד ב-urlencoded. נעדכן את הערכים הנדרשים לפני שליחת הבקשה.<br>דוגמה:<br><code>http://your-server.com/pingscript?id=$id</code><br><code>http://your-server.com/pingscript?id=$id&amp;tag=$tag</code><br><strong>הערה:</strong> תווים מיוחדים ב-<code>pingback_url</code> יקודדו ב-urlencoded;<br>לדוגמה, התו <code>#</code> יקודד ל-<code>%23</code><p>מידע נוסף במרכז העזרה שלנו"
          }
        },
        "example": [
          {
            "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"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "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"
    }
  ]
}
```

## Responses

### 200 — פעולה מוצלחת

Headers:
- `X-Request-Id` (string) — מזהה בקשה לכלול בעת פנייה לתמיכת Felo.

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_OnPageTaskPostResponseInfo"
    }
  ]
}
```

### 400 — לא ניתן היה לעבד את הבקשה. בדקו את פרמטרי הבקשה.

### 401 — נדרש מפתח API תקף של Felo.

### 402 — לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.

### 403 — החשבון אינו מורשה לבצע את הפעולה הזו.

### 429 — הגעתם למגבלת בקשות או לתקרת הוצאה.

### 502 — השירות לא הצליח להשלים את הבקשה.

### 503 — שירות ה-API או החיוב אינו זמין באופן זמני.

### 504 — השירות פג בזמן הטיפול בבקשה.

### default — תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "הגרסה הנוכחית של ה-API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "קוד סטטוס כללי\nאת הרשימה המלאה של קודי התגובה אפשר למצוא כאן"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "הודעה אינפורמטיבית כללית\nאת הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "זמן ביצוע כולל, בשניות"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "סך עלות המשימות, בדולר ארה״ב",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "מספר המשימות במערך tasks",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "מספר המשימות במערך tasks שהוחזרו עם שגיאה",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "מזהה משימה\nמזהה משימה ייחודי במערכת שלנו בפורמט UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "קוד הסטטוס של המשימה\nנוצר על ידי DataForSEO ויכול להיות בטווח הבא: 10000-60000\nאת הרשימה המלאה של קודי התגובה אפשר למצוא כאן"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "הודעה אינפורמטיבית של המשימה\nאת הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "זמן ביצוע, בשניות"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "סך עלות המשימות, בדולר ארה״ב",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "מספר הפריטים במערך result",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "נתיב URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "מכיל את אותם הפרמטרים שציינתם בבקשת POST"
    }
  }
}
```

### Response36Afe1097B20_OnPageTaskPostResponseInfo

`#/components/schemas/Response36Afe1097B20_OnPageTaskPostResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_OnPageTaskPostTaskInfo"
              }
            ]
          },
          "description": "<em>מערך משימות</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_OnPageTaskPostTaskInfo

`#/components/schemas/Response36Afe1097B20_OnPageTaskPostTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "object",
            "null"
          ],
          "description": "<em>מערך תוצאות</em><br>במקרה זה, הערך יהיה <code>null</code>"
        }
      }
    }
  ]
}
```
