# תצוגה מסכמת של מילות מפתח

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/dataforseo_labs/google/keyword_overview/live`

**Tags:** DataForSEO

כל מה ש-Labs יודע על רשימת `keywords` בקריאה אחת: נפח, קושי, כוונה, תחרות ותכונות ה-SERP שהן מעוררות. מחזיר `se_type`, `location_code`, `language_code`, `items_count` ו-`items`. אין כאן פרמטר limit, אך התמחור לפי קריאה ולא לפי פריט, לכן שלחו את כל הרשימה בבת אחת. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-`tasks[0].result`, והתוצאה ב-`tasks[0].status_code` — גם בקשה שנדחתה מחזירה HTTP 200. התחילו כאן כשיש לכם מילות מפתח; `post_dataforseo_labs_google_keyword_ideas_live` היא היעד כשצריך עוד מהן.

### מראה תמחור

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

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

## Related links

- [מאמר במרכז העזרה](<https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis>)
- [מאמר במרכז העזרה](<https://dataforseo.com/help-center/what-are-clickstream-based-metrics-and-how-do-we-calculate-them>)
- [מאמר מרכז העזרה הזה](<https://dataforseo.com/help-center/search-intent-and-its-types>)
- [במאמר מרכז העזרה הזה](<https://dataforseo.com/help-center/what-is-competition>)
- [הרשימה המלאה של קטגוריות אפשריות](<https://cdn.dataforseo.com/v3/categories/categories_dataforseo_labs_2023_10_25.csv>)
- [במדריך מרכז העזרה הזה](<https://dataforseo.com/help-center/what-is-keyword-difficulty-and-how-is-it-calculated>)
- [מאמר מרכז העזרה הזה](<https://dataforseo.com/help-center/what_is_rank_in_backlinks_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": {
          "keywords": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "<em>keywords</em><br><strong>שדה חובה</strong><br>המספר המרבי של מילות מפתח שאפשר לציין: 700<br>המספר המרבי של תווים בכל מילת מפתח: 80<br>המספר המרבי של מילים בכל ביטוי מפתח: 10<br>מילות המפתח שצוינו יומרו לאותיות קטנות, והנתונים יסופקו במערך נפרד<p><strong>הערה</strong> שאם חלק ממילות המפתח שצוינו במערך זה מושמטות מהתוצאות שתקבלו, פירוש הדבר שמסד הנתונים שלנו אינו מכיל אותן מילות מפתח ואינו יכול להחזיר עליהן נתונים<br>לא תחויבו עבור מילות המפתח שהושמטו מהתוצאות<p>מידע נוסף על הכללים והמגבלות של השדות <code>keyword</code> ו-<code>keywords</code> ב-DataForSEO API מופיע במאמר במרכז העזרה"
          },
          "location_name": {
            "type": "string",
            "description": "<em>השם המלא של המיקום</em><br><strong>שדה חובה אם לא מציינים</strong> <code>location_code</code><br><strong>הערה:</strong> יש לציין <code>location_name</code> או <code>location_code</code><br>אפשר לקבל את רשימת המיקומים הזמינים עם <code>location_name</code> שלהם באמצעות בקשה נפרדת אל <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>דוגמה:<br><code class=\"long-string\">United Kingdom</code>"
          },
          "location_code": {
            "type": "integer",
            "description": "<em>קוד מיקום</em><br><strong>שדה חובה אם לא מציינים</strong> <code>location_name</code><br><strong>הערה:</strong> יש לציין <code>location_name</code> או <code>location_code</code><br>אפשר לקבל את רשימת המיקומים הזמינים עם <code>location_code</code> שלהם באמצעות בקשה נפרדת אל <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>דוגמה:<br><code class=\"long-string\">2840</code>"
          },
          "language_name": {
            "type": "string",
            "description": "<em>השם המלא של השפה</em><br><strong>שדה חובה אם לא מציינים</strong> <code>language_code</code><br><strong>הערה:</strong> יש לציין <code>language_name</code> או <code>language_code</code><br>אפשר לקבל את רשימת המיקומים הזמינים עם <code>language_name</code> שלהם באמצעות בקשה נפרדת אל <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>דוגמה:<br><code class=\"long-string\">English</code>"
          },
          "language_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>קוד שפה</em><br><strong>שדה חובה אם לא מציינים</strong> <code>language_name</code><br><strong>הערה:</strong> יש לציין <code>language_name</code> או <code>language_code</code><br>אפשר לקבל את רשימת המיקומים הזמינים עם <code>language_code</code> שלהם באמצעות בקשה נפרדת אל <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>דוגמה:<br><code class=\"long-string\">en</code>"
          },
          "include_serp_info": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>כלילת נתונים מ-SERP עבור כל מילת מפתח</em><br>שדה אופציונלי<br>אם הערך הוא <code>true</code>, נחזיר מערך <code>serp_info</code> המכיל נתוני SERP (מספר תוצאות חיפוש, כתובת URL רלוונטית ותכונות SERP) עבור כל מילת מפתח בתגובה<br>ברירת מחדל: <code>false</code>"
          },
          "include_clickstream_data": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>כלילה או החרגה של נתונים ממדדים מבוססי Clickstream בתגובה</em><br>שדה אופציונלי<br>אם הפרמטר מוגדר ל-<code>true</code>, תקבלו את השדות <code>clickstream_keyword_info</code>, <code>keyword_info_normalized_with_clickstream</code> ו-<code>keyword_info_normalized_with_bing</code> בתגובה<br>ברירת מחדל: <code>false</code><br>כשהפרמטר מופעל, תחויבו במחיר כפול עבור הבקשה<p>מידע נוסף על אופן חישוב המדדים מבוססי Clickstream מופיע במאמר במרכז העזרה"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>מזהה משימה מוגדר על ידי המשתמש</em><br>שדה אופציונלי<br><em>מגבלת התווים היא 255</em><br>אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה<br>את ערך ה-<code>tag</code> שציינתם תמצאו באובייקט <code>data</code> של התגובה"
          }
        },
        "example": [
          {
            "language_code": "en",
            "location_code": 2840,
            "include_clickstream_data": true,
            "include_serp_info": true,
            "keywords": [
              "iphone"
            ]
          }
        ]
      }
    ]
  },
  "example": [
    {
      "language_code": "en",
      "location_code": 2840,
      "include_clickstream_data": true,
      "include_serp_info": true,
      "keywords": [
        "iphone"
      ]
    }
  ]
}
```

## Responses

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

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

**application/json**

Schema: object | null

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

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

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

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

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

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

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

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

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

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

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_AvgBacklinksInfo

`#/components/schemas/Response36Afe1097B20_AvgBacklinksInfo`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>סוג מנוע החיפוש</em>"
    },
    "backlinks": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>מספר קישורים נכנסים ממוצע</em>"
    },
    "dofollow": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>מספר ממוצע של קישורי dofollow</em>"
    },
    "referring_pages": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>מספר ממוצע של דפים מפנים</em>"
    },
    "referring_domains": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>מספר ממוצע של דומיינים מפנים</em>"
    },
    "referring_main_domains": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>מספר ממוצע של דומיינים ראשיים מפנים</em>"
    },
    "rank": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>דירוג ממוצע</em><br>מידע נוסף על המדד ונוסחת החישוב שלו במאמר מרכז העזרה הזה"
    },
    "main_domain_rank": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>דירוג דומיין ראשי ממוצע</em><br>מידע נוסף על המדד ונוסחת החישוב שלו במאמר הזה במרכז העזרה"
    },
    "last_updated_time": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>התאריך והשעה שבהם נתוני מילת המפתח עודכנו</em><br>בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”<br>דוגמה:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00</code>"
    }
  }
}
```

### 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_ClickstreamKeywordInfo

`#/components/schemas/Response36Afe1097B20_ClickstreamKeywordInfo`

```json
{
  "type": "object",
  "properties": {
    "search_volume": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>שיעור נפח חיפוש חודשי ממוצע</em><br>מייצג את המספר (המשוער) של חיפושים ברעיון מילת המפתח הנתון ב-google.com",
      "format": "int64"
    },
    "last_updated_time": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>התאריך והשעה שבהם נתוני מילת המפתח עודכנו</em><br>בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”<br>דוגמה:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00</code>"
    },
    "gender_distribution": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>התפלגות מדדים מוערכים מבוססי Clickstream לפי מגדר</em><br>מידע נוסף על אופן חישוב המדד זמין במאמר מרכז העזרה הזה"
    },
    "age_distribution": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>התפלגות מדדים מבוססי Clickstream לפי גיל</em><br>מידע נוסף על אופן חישוב המדד זמין במאמר מרכז העזרה הזה"
    },
    "monthly_searches": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_MonthlySearchesInfo"
          }
        ]
      },
      "description": "<em>חיפושים חודשיים</em><br>מייצג את המספר (המשוער) של חיפושים ברעיון מילת המפתח הזה (כפי שזמין בשנים עשר החודשים האחרונים), הממוקדים במיקומים הגאוגרפיים שצוינו"
    }
  }
}
```

### Response36Afe1097B20_DataforseoLabsGoogleKeywordOverviewLiveItem

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleKeywordOverviewLiveItem`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>סוג מנוע החיפוש</em>"
    },
    "keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>מילת מפתח</em><br><strong>מילת המפתח מוחזרת עם פענוח %## (התו '+' יפענח לרווח)</strong>"
    },
    "location_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>קוד מיקום במערך POST</em>"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>קוד שפה במערך POST</em>"
    },
    "search_partners": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "<em>מציין נתונים עבור Google ואתרים שותפים</em><br>אם <code class=\"prettyprint\">true</code>, התוצאות מוחזרות עבור רשתות בבעלות, מופעלות ומופצות ברחבי Google ואתרים שותפים שמארחים את חיפוש Google<br>אם <code>false</code>, התוצאות מוחזרות רק עבור אתרי חיפוש Google"
    },
    "keyword_info": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_KeywordInfo"
        }
      ],
      "description": "<em>נתוני מילת מפתח עבור מילת המפתח שהוחזרה</em>"
    },
    "keyword_info_normalized_with_bing": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_KeywordInfoNormalizedWithInfo"
        }
      ],
      "description": "<em>מכיל נפח חיפוש של מילת מפתח מנורמל לנפח החיפוש ב-Bing</em>"
    },
    "keyword_info_normalized_with_clickstream": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_KeywordInfoNormalizedWithInfo"
        }
      ],
      "description": "<em>מכיל נפח חיפוש של מילת מפתח מנורמל לנתוני זרימת קליקים<br></em>"
    },
    "clickstream_keyword_info": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_ClickstreamKeywordInfo"
        }
      ],
      "description": "<em>נתוני זרימת קליקים עבור מילת המפתח שהוחזרה</em><br>כדי לאחזר תוצאות עבור שדה זה, יש להגדיר את הפרמטר <code>include_clickstream_data</code> ל-<code>true</code>"
    },
    "keyword_properties": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_KeywordProperties"
        }
      ],
      "description": "<em>מידע נוסף על מילת המפתח</em>"
    },
    "serp_info": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_SerpInfo"
        }
      ],
      "description": "<em>נתוני SERP</em><br>הערך יהיה <code>null</code> אם לא הגדרתם את השדה <code>include_serp_info</code> ל-<code>true</code> במערך POST או אם אין נתוני SERP עבור מילת מפתח זו במסד הנתונים שלנו"
    },
    "avg_backlinks_info": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_AvgBacklinksInfo"
        }
      ],
      "description": "<em>נתוני קישורים נכנסים עבור מילת המפתח שהוחזרה</em><br>אובייקט זה מספק את המספר הממוצע של קישורים נכנסים, עמודים מפנים ודומיינים, וכן את ערכי הדירוג הממוצעים בקרב 10 האתרים המובילים שמדורגים אורגנית עבור מילת המפתח"
    },
    "search_intent_info": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_SearchIntentInfo"
        }
      ],
      "description": "<em>מידע על כוונת החיפוש עבור מילת המפתח שהוחזרה</em><br>מידע על כוונת חיפוש במאמר מרכז העזרה הזה"
    }
  }
}
```

### Response36Afe1097B20_DataforseoLabsGoogleKeywordOverviewLiveResponseInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleKeywordOverviewLiveResponseInfo`

```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_DataforseoLabsGoogleKeywordOverviewLiveTaskInfo"
              }
            ]
          },
          "description": "<em>מערך משימות</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_DataforseoLabsGoogleKeywordOverviewLiveResultInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleKeywordOverviewLiveResultInfo`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>סוג מנוע החיפוש</em>"
    },
    "location_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>קוד מיקום במערך POST</em>"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>קוד שפה במערך POST</em>"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>מספר התוצאות שהוחזרו במערך <code>items</code></em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleKeywordOverviewLiveItem"
          }
        ]
      },
      "description": "<em>מכיל מילות מפתח ונתונים קשורים</em>"
    }
  }
}
```

### Response36Afe1097B20_DataforseoLabsGoogleKeywordOverviewLiveTaskInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleKeywordOverviewLiveTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleKeywordOverviewLiveResultInfo"
              }
            ]
          },
          "description": "<em>מערך תוצאות</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_KeywordInfo

`#/components/schemas/Response36Afe1097B20_KeywordInfo`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>סוג מנוע החיפוש</em>"
    },
    "last_updated_time": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>התאריך והשעה שבהם נתוני מילת המפתח עודכנו</em><br>בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”<br>דוגמה:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00</code>"
    },
    "competition": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>תחרות</em><br>מייצג את הכמות היחסית של תחרות הקשורה למילת המפתח הנתונה. הערך מבוסס על נתוני Google Ads ויכול לנוע בין 0 ל-1 (כולל)"
    },
    "competition_level": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>רמת תחרות</em><br>מייצג את הרמה היחסית של תחרות הקשורה למילת המפתח הנתונה ב-SERP ממומן בלבד;<br>ערכים אפשריים: <code>LOW</code>, <code>MEDIUM</code>, <code>HIGH</code><br>אם רמת התחרות אינה ידועה, הערך הוא <code>null</code>;<br>מידע נוסף על המדד במאמר מרכז העזרה הזה"
    },
    "cpc": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>עלות לקליקה</em><br>מייצג את העלות הממוצעת לקליקה (בדולר ארה״ב) ששולמה היסטורית עבור מילת המפתח"
    },
    "search_volume": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>שיעור נפח חיפוש חודשי ממוצע</em><br>מייצג את המספר (המשוער) של חיפושים ברעיון מילת המפתח הנתון ב-google.com",
      "format": "int64"
    },
    "low_top_of_page_bid": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>ההצעה המינימלית להצגת המודעה בראש העמוד הראשון</em><br>מציין ערך הגדול מכ-20% מההצעות הנמוכות ביותר שבהן הוצגו מודעות (בהתבסס על סטטיסטיקות Google Ads למפרסמים)<br>הערך עשוי להשתנות בהתאם למיקום שצוין בבקשת POST"
    },
    "high_top_of_page_bid": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>ההצעה המקסימלית להצגת המודעה בראש העמוד הראשון</em><br>מציין ערך הגדול מכ-80% מההצעות הנמוכות ביותר שבהן הוצגו מודעות (בהתבסס על סטטיסטיקות Google Ads למפרסמים)<br>הערך עשוי להשתנות בהתאם למיקום שצוין בבקשת POST"
    },
    "categories": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "integer"
      },
      "description": "<em>קטגוריות מוצרים ושירותים</em><br>תוכלו להוריד את הרשימה המלאה של קטגוריות אפשריות"
    },
    "monthly_searches": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_MonthlySearchesInfo"
          }
        ]
      },
      "description": "<em>חיפושים חודשיים</em><br>מייצג את המספר (המשוער) של חיפושים ברעיון מילת המפתח הזה (כפי שזמין בשנים עשר החודשים האחרונים), הממוקדים במיקומים הגאוגרפיים שצוינו"
    },
    "search_volume_trend": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_SearchVolumeTrend"
        }
      ],
      "description": "<em>שינויים במגמת נפח החיפוש</em><br>מייצג את השינוי בנפח החיפוש באחוזים לעומת התקופה הקודמת"
    }
  }
}
```

### Response36Afe1097B20_KeywordInfoNormalizedWithInfo

`#/components/schemas/Response36Afe1097B20_KeywordInfoNormalizedWithInfo`

```json
{
  "type": "object",
  "properties": {
    "last_updated_time": {
      "type": [
        "string",
        "null"
      ],
      "description": "התאריך והשעה שבהם מערך הנתונים עודכן\nבפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”\nדוגמה:\n2019-11-15 12:57:46 +00:00"
    },
    "search_volume": {
      "type": [
        "integer",
        "null"
      ],
      "description": "שיעור נפח החיפוש הנוכחי של מילת מפתח"
    },
    "is_normalized": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "מידע מילת המפתח מנורמל\nאם הערך true, הערכים מנורמלים עם נתוני Bing"
    },
    "monthly_searches": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_MonthlySearchesInfo"
          }
        ]
      },
      "description": "שיעורי נפח חיפוש חודשיים\nמערך אובייקטים עם שיעורי נפח חיפוש בחודש מסוים של השנה"
    }
  }
}
```

### Response36Afe1097B20_KeywordProperties

`#/components/schemas/Response36Afe1097B20_KeywordProperties`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>סוג מנוע החיפוש</em>"
    },
    "core_keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>מילת המפתח הראשית בקבוצה</em><br>מכיל את מילת המפתח הראשית בקבוצה שנקבעת על ידי אלגוריתם אשכול המילים הנרדפות<br>אם הערך הוא <code>null</code>, מסד הנתונים שלנו אינו מכיל מילות מפתח שהאלגוריתם המתאים יכול היה לזהות כנרדפות ל-<code>keyword</code>"
    },
    "synonym_clustering_algorithm": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>האלגוריתם ששימש לזיהוי מילים נרדפות</em><br>ערכים אפשריים:<br><code>keyword_metrics</code> - מציין את האלגוריתם המבוסס על פרמטרי <code>keyword_info</code><br><code>text_processing</code> - מציין את האלגוריתם המבוסס על טקסט<br>אם הערך הוא <code>null</code>, מסד הנתונים שלנו אינו מכיל מילות מפתח שהאלגוריתם המתאים יכול היה לזהות כנרדפות ל-<code>keyword</code>"
    },
    "keyword_difficulty": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>רמת הקושי לדירוג בעשרת התוצאות האורגניות הראשונות עבור מילת מפתח</em><br>מציין את הסיכוי להיכנס לעשרת התוצאות האורגניות הראשונות עבור מילת מפתח בסולם לוגריתמי מ-0 עד 100;<br>מחושב על ידי ניתוח, בין היתר, של פרופילי קישורים של 10 העמודים הראשונים ב-SERP;<br>מידע נוסף על המדד במדריך מרכז העזרה הזה"
    },
    "detected_language": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>השפה שזוהתה של מילת המפתח</em><br>מציין את השפה של מילת המפתח כפי שזוהתה על ידי המערכת שלנו"
    },
    "is_another_language": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "<em>השפה שזוהתה של מילת המפתח שונה מהשפה שהוגדרה</em><br>אם <code>true</code>, השפה שהוגדרה בבקשה אינה תואמת לשפה שהמערכת שלנו זיהתה עבור מילת מפתח נתונה"
    },
    "words_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>מספר המילים במילת המפתח</em><br>מציין מכמה מילים מורכבת מילת המפתח",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_MonthlySearchesInfo

`#/components/schemas/Response36Afe1097B20_MonthlySearchesInfo`

```json
{
  "type": "object",
  "properties": {
    "year": {
      "type": [
        "integer",
        "null"
      ],
      "description": "שנה"
    },
    "month": {
      "type": [
        "integer",
        "null"
      ],
      "description": "חודש"
    },
    "search_volume": {
      "type": [
        "integer",
        "null"
      ],
      "description": "שיעור נפח חיפוש חודשי ממוצע"
    }
  }
}
```

### Response36Afe1097B20_SearchIntentInfo

`#/components/schemas/Response36Afe1097B20_SearchIntentInfo`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>סוג מנוע החיפוש</em>"
    },
    "main_intent": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>כוונת החיפוש הראשית</em><br>ערכים אפשריים: <code>informational</code>, <code>navigational</code>, <code>commercial</code>, <code>transactional</code>"
    },
    "foreign_intent": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>כוונות חיפוש משלימות</em><br>ערכים אפשריים: <code>informational</code>, <code>navigational</code>, <code>commercial</code>, <code>transactional</code>"
    },
    "last_updated_time": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>התאריך והשעה שבהם נתוני מילת המפתח עודכנו</em><br>בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”<br>דוגמה:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00</code>"
    }
  }
}
```

### Response36Afe1097B20_SearchVolumeTrend

`#/components/schemas/Response36Afe1097B20_SearchVolumeTrend`

```json
{
  "type": "object",
  "properties": {
    "monthly": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>שינוי בנפח החיפוש באחוזים לעומת החודש הקודם</em>"
    },
    "quarterly": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>שינוי בנפח החיפוש באחוזים לעומת הרבעון הקודם</em>"
    },
    "yearly": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>שינוי בנפח החיפוש באחוזים לעומת השנה הקודמת</em>"
    }
  }
}
```

### Response36Afe1097B20_SerpInfo

`#/components/schemas/Response36Afe1097B20_SerpInfo`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>סוג מנוע החיפוש</em>"
    },
    "check_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>כתובת URL ישירה לתוצאות מנוע החיפוש</em><br>אפשר להשתמש בה כדי לוודא שסיפקנו תוצאות מדויקות"
    },
    "serp_item_types": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>סוגי תוצאות החיפוש ב-SERP</em><br>מכיל את סוגי תוצאות החיפוש (items) שנמצאו ב-SERP<br>סוגי פריטים אפשריים:<br><code>answer_box</code>, <code>app</code>, <code>carousel</code>, <code>multi_carousel</code>, <code>featured_snippet</code>, <code>google_flights</code>, <code>google_reviews</code>, <code>third_party_reviews</code>, <code>google_posts</code>, <code>images</code>, <code>jobs</code>, <code>knowledge_graph</code>, <code>local_pack</code>, <code>hotels_pack</code>, <code>map</code>, <code>organic</code>, <code>paid</code>, <code>people_also_ask</code>, <code>related_searches</code>, <code>people_also_search</code>, <code>shopping</code>, <code>top_stories</code>, <code>twitter</code>, <code>video</code>, <code>events</code>, <code>mention_carousel</code>, <code>recipes</code>, <code>top_sights</code>, <code>scholarly_articles</code>, <code>popular_products</code>, <code>podcasts</code>, <code>questions_and_answers</code>, <code>find_results_on</code>, <code>stocks_box</code>, <code>visual_stories</code>, <code>commercial_units</code>, <code>local_services</code>, <code>google_hotels</code>, <code>math_solver</code>, <code>currency_box</code>, <code>product_considerations</code>, <code>found_on_web</code>, <code>short_videos</code>, <code>refine_products</code>, <code>explore_brands</code>, <code>perspectives</code>, <code>discussions_and_forums</code>, <code>compare_sites</code>, <code>courses</code>, <code>ai_overview</code>;<br><strong>הערה</strong> שהתוצאות בפועל יוחזרו רק עבור רכיבי <code>organic</code>, <code>paid</code>, <code>featured_snippet</code> ו-<code>local_pack</code>"
    },
    "se_results_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>מספר תוצאות החיפוש עבור מילת המפתח שהוחזרה</em>",
      "format": "int64"
    },
    "last_updated_time": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>התאריך והשעה שבהם נתוני מילת המפתח עודכנו</em><br>בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”<br>דוגמה:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00</code>"
    },
    "previous_updated_time": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>התאריך והשעה שלפני התאריך והשעה העדכניים ביותר שבהם נתוני SERP עודכנו</em><br>בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”<br>דוגמה:<br><code class=\"long-string\">2019-10-15 12:57:46 +00:00</code>"
    }
  }
}
```
