# חיפושים מובילים

**API:** Data API

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

**Tags:** DataForSEO

מילות המפתח בנפח הגבוה ביותר במיקום, ללא סינון לפי זרע או אתר. עימוד עם `limit`, `offset` ו-`offset_token`; השתמשו בטוקן לאחר העמודים הראשונים. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-`tasks[0].result`, והתוצאה ב-`tasks[0].status_code` — גם בקשה שנדחתה מחזירה HTTP 200. זהו קצה הגילוי של המשפחה: השתמשו בו כשאין עדיין מילת מפתח זרע, ואז צמצמו עם `post_dataforseo_labs_google_keyword_ideas_live`.

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

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

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

## Related links

- [מאמר במרכז העזרה](<https://dataforseo.com/help-center/what-are-clickstream-based-metrics-and-how-do-we-calculate-them>)
- [Dataforseo Labs - Filters](<https://docs.dataforseo.com/v3/dataforseo_labs/filters>)
- [מדריך מרכז העזרה](<https://dataforseo.com/help-center/how-to-use-filters-in-dataforseo-labs-api>)
- [מרכז העזרה](<https://dataforseo.com/help-center/what-is-the-difference-between-the-offset-and-offset_token-parameters#offset_token>)
- [מאמר מרכז העזרה הזה](<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": {
          "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 מופיע במאמר במרכז העזרה"
          },
          "ignore_synonyms": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>התעלמות ממילות מפתח דומות מאוד</em><br>שדה אופציונלי<br>אם הערך הוא <code class=\"prettyprint\">true</code>, יוחזרו רק מילות המפתח הליבה וכל מילות המפתח הדומות מאוד יוחרגו;  <br>ברירת מחדל: <code>false</code>"
          },
          "filters": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": [
                "object",
                "null"
              ]
            },
            "description": "<em>מערך פרמטרים לסינון תוצאות</em><br>שדה אופציונלי<br><strong>אפשר להוסיף כמה מסננים בבת אחת (עד 8 מסננים)</strong><br>יש להגדיר אופרטור לוגי <code>and</code> או <code>or</code> בין התנאים<br>האופרטורים הנתמכים:<br><code>regex</code>, <code>not_regex</code>, <code>&lt;</code>, <code>&lt;=</code>, <code>&gt;</code>, <code>&gt;=</code>, <code>=</code>, <code>&lt;&gt;</code>, <code>in</code>, <code>not_in</code>, <code>match</code>, <code>not_match</code>, <code>ilike</code>, <code>not_ilike</code>, <code>like</code>,<code>not_like</code><br>אפשר להשתמש באופרטור <code>%</code> עם <code>like</code> ו-<code>not_like</code>, וכן <code>ilike</code> ו-<code>not_ilike</code>, כדי להתאים כל מחרוזת של אפס תווים או יותר<br>דוגמה:<br><code>[\"keyword_info.search_volume\",\"&gt;\",0]</code><p><code>[[\"keyword_info.search_volume\",\"in\",[0,1000]],<br>\"and\",<br>[\"keyword_info.competition_level\",\"=\",\"LOW\"]]</code><p><code>[[\"keyword_info.search_volume\",\"&gt;\",100],<br>\"and\",<br>[[\"keyword_info.cpc\",\"&lt;\",0.5],<br>\"or\",<p>[\"keyword_info.high_top_of_page_bid\",\"&lt;=\",0.5]]]</code><br>למידע נוסף על מסננים ראו Dataforseo Labs - Filters או מדריך מרכז העזרה"
          },
          "order_by": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>כללי מיון תוצאות</em><br>שדה אופציונלי<br>אפשר להשתמש באותם ערכים כמו במערך <code>filters</code> כדי למיין את התוצאות<br>סוגי מיון אפשריים:<br><code>asc</code> - התוצאות ימוינו בסדר עולה<br><code>desc</code> - התוצאות ימוינו בסדר יורד<br>יש להשתמש בפסיק כדי להגדיר סוג מיון<br>דוגמה:<br><code>[\"keyword_info.competition,desc\"]</code><br>כלל ברירת מחדל:<br><code>[\"keyword_info.search_volume,desc\"]</code><br><strong>שימו לב שלא ניתן להגדיר יותר משלושה כללי מיון בבקשה אחת</strong><br>יש להשתמש בפסיק כדי להפריד בין כמה כללי מיון<br>דוגמה:<br><code>[\"keyword_info.search_volume,desc\",\"keyword_info.cpc,desc\"]</code>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>מזהה משימה מוגדר על ידי המשתמש</em><br>שדה אופציונלי<br><em>מגבלת התווים היא 255</em><br>אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה<br>את ערך ה-<code>tag</code> שציינתם תמצאו באובייקט <code>data</code> של התגובה"
          },
          "limit": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>המספר המרבי של מילות מפתח מוחזרות</em><br>שדה אופציונלי<br></strong>הערה:</strong> אפשר לקבל יותר מ-1000 תוצאות באמצעות <code>offset_token</code> שמסופק בתגובה לכל בקשת המשך<br>ערך ברירת מחדל: <code>1000</code><br>ערך מרבי: <code>1000</code>"
          },
          "offset": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>היסט במערך התוצאות של מילות המפתח המוחזרות</em><br>שדה אופציונלי<br>ערך ברירת מחדל: <code>0</code><br>אם תציינו את הערך <code>10</code>, עשר מילות המפתח הראשונות במערך התוצאות יושמטו והנתונים יסופקו עבור מילות המפתח העוקבות<br><strong>הערה:</strong> אנו ממליצים להשתמש בפרמטר הזה רק כשמאחזרים עד 10,000 תוצאות<br>לאחזור יותר מ-10,000 תוצאות, השתמשו ב-<code>offset_token</code> במקום."
          },
          "offset_token": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>טוקן היסט לבקשות המשך</em><br>שדה אופציונלי<br>מסופק בשדה הזהה בתגובה לכל בקשה;<br>השתמשו בפרמטר הזה כדי להימנע מפסקי זמן כשמנסים לקבל יותר מ-10,000 תוצאות בבקשה אחת;<br>אם תציינו את ערך <code>offset_token</code> הייחודי ממערך התגובה, תקבלו את התוצאות הבאות של המשימה הראשונית;<br>ערכי <code>offset_token</code> ייחודיים לכל משימת המשך <br><strong>הערה:</strong> אם מצוין <code>offset_token</code> בבקשה, כל שאר הפרמטרים למעט <code>limit</code> לא יילקחו בחשבון בעת עיבוד המשימה.<br>מידע נוסף על הפרמטר הזה במרכז העזרה שלנו"
          }
        },
        "example": [
          {
            "language_name": "English",
            "location_code": 2840,
            "limit": 3
          }
        ]
      }
    ]
  },
  "example": [
    {
      "language_name": "English",
      "location_code": 2840,
      "limit": 3
    }
  ]
}
```

## Responses

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

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

**application/json**

Schema: object | null

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

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

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleTopSearchesLiveResponseInfo`

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

### Response36Afe1097B20_DataforseoLabsGoogleTopSearchesLiveResultInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleTopSearchesLiveResultInfo`

```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>"
    },
    "total_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>הסכום הכולל של תוצאות במסד הנתונים שלנו הרלוונטיות לבקשה שלכם</em>",
      "format": "int64"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>מספר התוצאות שהוחזרו במערך <code>items</code></em>",
      "format": "int64"
    },
    "offset": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>ערך ההיסט הנוכחי</em>"
    },
    "offset_token": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>טוקן היסט לבקשות עוקבות</em><br>אפשר להשתמש במחרוזת שמסופקת בשדה הזה כדי לקבל את התוצאות העוקבות של המשימה הראשונית;<br><strong>הערה:</strong> ערכי <code>offset_token</code> ייחודיים לכל משימה עוקבת"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_KeywordDataInfo"
          }
        ]
      },
      "description": "<em>מכיל מילות מפתח ונתונים קשורים</em>"
    }
  }
}
```

### Response36Afe1097B20_DataforseoLabsGoogleTopSearchesLiveTaskInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleTopSearchesLiveTaskInfo`

```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_DataforseoLabsGoogleTopSearchesLiveResultInfo"
              }
            ]
          },
          "description": "<em>מערך תוצאות</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_KeywordDataInfo

`#/components/schemas/Response36Afe1097B20_KeywordDataInfo`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>סוג מנוע החיפוש</em>"
    },
    "keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>רעיון מילת המפתח שהוחזר</em>"
    },
    "location_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>קוד מיקום במערך POST</em>"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>קוד שפה במערך POST</em>"
    },
    "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_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>"
    }
  }
}
```
