# 키워드 개요

**API:** Data API

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

**Tags:** DataForSEO

한 번의 호출로 `keywords` 목록에 대해 Labs가 아는 모든 것을 조회합니다: 검색량, 난이도, 의도, 경쟁도, 유발하는 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`로 가세요.

### 가격 참고

- 과금 기준: 응답에 보고된 비용.
- 참고 요청 추정치: USD 0.0254.
- 참고 고객 배수: 1.0. 이미 정산된 고객 금액에는 다시 적용하지 마세요.

참고용 메타데이터일 뿐이며, 계정 견적이나 보장된 가격, 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.

## 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>DataForSEO API에서 <code>keyword</code> 및 <code>keywords</code> 필드의 규칙과 제한은 이 <a href=\"https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis\" rel=\"noopener noreferrer\" target=\"_blank\">도움말 센터 문서</a>에서 자세히 알아보세요"
          },
          "location_name": {
            "type": "string",
            "description": "<em>위치의 전체 이름</em><br><strong><code>location_code</code>를 지정하지 않은 경우 필수 필드</strong><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><code>location_name</code>을 지정하지 않은 경우 필수 필드</strong><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><code>language_code</code>를 지정하지 않은 경우 필수 필드</strong><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><code>language_name</code>을 지정하지 않은 경우 필수 필드</strong><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>로 설정하면 응답의 모든 키워드에 대해 SERP 데이터(검색 결과 수, 관련 URL, SERP 기능)가 담긴 <code>serp_info</code> 배열을 반환합니다<br>기본값: <code>false</code>"
          },
          "include_clickstream_data": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>결과에서 클릭스트림 기반 지표 데이터 포함 또는 제외</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>클릭스트림 기반 지표의 계산 방식은 이 <a href=\"https://dataforseo.com/help-center/what-are-clickstream-based-metrics-and-how-do-we-calculate-them\" rel=\"noopener noreferrer\" target=\"_blank\">도움말 센터 문서</a>에서 자세히 알아보세요"
          },
          "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 — 유효한 Felo API 키가 필요합니다.

### 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>지표와 계산 공식은 <a href=\"https://dataforseo.com/help-center/what_is_rank_in_backlinks_api\" target=\"_blank\" rel=\"noopener noreferrer\">이 도움말 센터 문서</a>에서 확인하세요"
    },
    "main_domain_rank": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>평균 기본 도메인 순위</em><br>이 지표와 계산 공식에 대한 자세한 내용은 <a href=\"https://dataforseo.com/help-center/what_is_rank_in_backlinks_api\" target=\"_blank\" rel=\"noopener noreferrer\">이 도움말 센터 문서</a>를 참고하세요"
    },
    "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": "전체 작업 비용, USD",
      "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": "작업의 상태 코드\nDataForSEO가 생성하며 10000-60000 범위일 수 있습니다.\n응답 코드 전체 목록은 여기에서 확인할 수 있습니다."
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "작업의 정보 메시지\n일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다."
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "실행 시간, 초"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "전체 작업 비용, USD",
      "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>성별별 예상 클릭스트림 기반 지표 분포</em><br>이 지표가 계산되는 방식은 <a href=\"https://dataforseo.com/help-center/what-are-clickstream-based-metrics-and-how-do-we-calculate-them\" rel=\"noopener noreferrer\" target=\"_blank\">이 도움말 센터 문서</a>에서 자세히 확인하세요"
    },
    "age_distribution": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>연령별 클릭스트림 기반 지표 분포</em><br>이 지표가 계산되는 방식은 <a href=\"https://dataforseo.com/help-center/what-are-clickstream-based-metrics-and-how-do-we-calculate-them\" rel=\"noopener noreferrer\" target=\"_blank\">이 도움말 센터 문서</a>에서 자세히 확인하세요"
    },
    "monthly_searches": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_MonthlySearchesInfo"
          }
        ]
      },
      "description": "<em>월간 검색 수</em><br>지정된 지리적 위치를 대상으로 이 키워드 아이디어에 대한 (대략적인) 검색 수를 나타냅니다(지난 12개월 기준)"
    }
  }
}
```

### 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>입니다: POST 배열에서 <code>include_serp_info</code>를 <code>true</code>로 설정하지 않았거나, 데이터베이스에 이 키워드의 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>검색 의도에 대한 내용은 <a href=\"https://dataforseo.com/help-center/search-intent-and-its-types\" rel=\"noopener noreferrer\" target=\"_blank\">이 도움말 센터 문서</a>에서 확인하세요"
    }
  }
}
```

### 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>이 지표에 대한 자세한 내용은 <a href=\"https://dataforseo.com/help-center/what-is-competition\" target=\"_blank\" rel=\"noopener noreferrer\">이 도움말 센터 문서</a>에서 확인하세요"
    },
    "cpc": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>클릭당 비용</em><br>해당 키워드에 대해 지금까지 지불된 평균 클릭당 비용(USD)을 나타냅니다"
    },
    "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><a href=\"https://cdn.dataforseo.com/v3/categories/categories_dataforseo_labs_2023_10_25.csv\">가능한 카테고리 전체 목록</a>을 다운로드할 수 있습니다"
    },
    "monthly_searches": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_MonthlySearchesInfo"
          }
        ]
      },
      "description": "<em>월간 검색 수</em><br>지정된 지리적 위치를 대상으로 이 키워드 아이디어에 대한 (대략적인) 검색 수를 나타냅니다(지난 12개월 기준)"
    },
    "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": "데이터 세트가 업데이트된 날짜와 시간\nUTC 형식: “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": "키워드 정보가 정규화되었는지 여부\ntrue이면 값이 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>키워드의 상위 10개 자연 검색 결과에 진입하기 위한 난이도</em><br>키워드가 상위 10개 자연 검색 결과에 진입할 가능성을 0에서 100까지의 로그 스케일로 나타냅니다.<br>SERP의 처음 10개 페이지 링크 프로필 등의 매개변수를 분석하여 계산합니다.<br>이 지표에 대한 자세한 내용은 <a href=\"https://dataforseo.com/help-center/what-is-keyword-difficulty-and-how-is-it-calculated\" target=\"_blank\" rel=\"noopener noreferrer\">이 도움말 센터 가이드</a>에서 확인하세요"
    },
    "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>이 URL로 우리가 정확한 결과를 제공했는지 확인할 수 있습니다"
    },
    "serp_item_types": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>SERP의 검색 결과 유형</em><br>SERP에서 발견된 검색 결과 유형(items)을 포함합니다<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>"
    }
  }
}
```