# 키워드 제안

**API:** Data API

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

**Tags:** DataForSEO

하나의 `keyword`를 포함하는 롱테일 변형입니다. 구문 일치 보기이며, 의미 기반 보기는 `post_dataforseo_labs_google_keyword_ideas_live`입니다. `seed_keyword`, `seed_keyword_data`, `total_count`, `offset_token`, `items`를 반환합니다. `limit`, `offset`, `offset_token`으로 페이지를 넘기며, 첫 페이지 이후에는 토큰을 사용하세요. DataForSEO 응답 봉투로 감싸집니다. 데이터는 `tasks[0].result`에, 결과는 `tasks[0].status_code`에 있으며, 거부된 요청도 여전히 HTTP 200을 반환합니다.

### 가격 참고

- 과금 기준: 응답에 보고된 비용.
- 참고 요청 추정치: USD 0.132.
- 참고 고객 배수: 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": {
          "keyword": {
            "type": "string",
            "description": "<em>키워드</em><br><strong>필수 필드</strong><br>UTF-8 인코딩<br>키워드는 소문자로 변환됩니다;<p><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",
              "null"
            ],
            "description": "<em>위치의 전체 이름</em><br>선택 필드<br>이 필드를 사용하면 <code>location_code</code>를 지정할 필요가 없습니다<br><code>location_name</code>으로 사용 가능한 위치 목록은 별도 요청으로 받을 수 있습니다<br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>사용 가능한 모든 위치의 결과를 받으려면 이 필드를 무시하세요<br>예시:<br><code class=\"long-string\">United Kingdom</code>"
          },
          "location_code": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>위치 코드</em><br>선택 필드<br>이 필드를 사용하면 <code>location_name</code>을 지정할 필요가 없습니다<br><code>location_code</code>로 사용 가능한 위치 목록은 별도 요청으로 받을 수 있습니다<br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>사용 가능한 모든 위치의 결과를 받으려면 이 필드를 무시하세요<br>예시:<br><code class=\"long-string\">2840</code>"
          },
          "language_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>언어의 전체 이름</em><br>선택 필드<br>이 필드를 사용하면 <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><br><strong>참고:</strong> 생략하면 지정한 위치에서 키워드 레코드가 가장 많은 언어가 기본으로 사용됩니다;<br>기본 언어를 확인하려면 <a href=\"https://docs.dataforseo.com/v3/dataforseo_labs/locations_and_languages\" target=\"_blank\">Locations and Languages 엔드포인트</a>의 <code>available_languages.keywords</code> 필드를 참조하세요"
          },
          "language_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>언어 코드</em><br>선택 필드<br>이 필드를 사용하면 <code>language_name</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><br><strong>참고:</strong> 생략하면 지정한 위치에서 키워드 레코드가 가장 많은 언어가 기본으로 사용됩니다;<br>기본 언어를 확인하려면 <a href=\"https://docs.dataforseo.com/v3/dataforseo_labs/locations_and_languages\" target=\"_blank\">Locations and Languages 엔드포인트</a>의 <code>available_languages.keywords</code> 필드를 참조하세요"
          },
          "include_seed_keyword": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>시드 키워드 데이터 포함</em><br>선택 필드<br><code>true</code>로 설정하면 <code>keyword</code> 필드에 지정한 시드 키워드의 데이터가 응답의 <code>seed_keyword_data</code> 배열에 제공됩니다<br>기본값: <code>false</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>에서 자세히 알아보세요"
          },
          "exact_match": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>정확한 구문 검색</em><br>선택 필드<br><code>true</code>로 설정하면 반환되는 키워드에 지정한 정확한 키워드 구문이 포함되며, 해당 구문 앞이나 뒤에 다른 단어가 있을 수 있습니다<br>기본값: <code>false</code>"
          },
          "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>와 함께 사용해 0자 이상의 임의 문자열을 일치시킬 수 있습니다<br>예시:<br><code>[\"keyword_info.search_volume\",\"&gt;\",0]</code><br><code>[[\"keyword_info.search_volume\",\"in\",[0,1000]],<br>\"and\",<br>[\"keyword_info.competition_level\",\"=\",\"LOW\"]]</code><code>[[\"keyword_info.search_volume\",\"&gt;\",100],<br>\"and\",<br>[[\"keyword_info.cpc\",\"&lt;\",0.5],<br>\"or\",<br>[\"keyword_info.high_top_of_page_bid\",\"&lt;=\",0.5]]]</code><br>필터에 대한 자세한 내용은 <a href=\"/v3/dataforseo_labs/filters\" target=\"_blank\" rel=\"noopener noreferrer\">Dataforseo Labs - Filters</a> 또는 <a href=\"https://dataforseo.com/help-center/how-to-use-filters-in-dataforseo-labs-api\" target=\"_blank\" rel=\"noopener noreferrer\">도움말 센터 가이드</a>를 참조하세요"
          },
          "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>한 요청에는 정렬 규칙을 최대 3개까지만 설정할 수 있습니다.</strong><br>여러 정렬 규칙은 쉼표로 구분해야 합니다<br>예시:<br><code>[\"keyword_info.search_volume,desc\",\"keyword_info.cpc,desc\"]</code>"
          },
          "limit": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>반환되는 키워드의 최대 수</em><br>선택 필드<br>기본값: <code>100</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>이 매개변수에 대한 자세한 내용은 <a href=\"https://dataforseo.com/help-center/what-is-the-difference-between-the-offset-and-offset_token-parameters#offset_token\" target=\"_blank\">도움말 센터</a>에서 확인하세요"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>사용자 정의 작업 식별자</em><br>선택 필드<br><em>최대 255자</em><br>이 매개변수를 사용해 작업을 식별하고 결과와 매칭할 수 있습니다<br><code>tag</code>에 지정한 값은 응답의 <code>data</code> 객체에서 확인할 수 있습니다"
          }
        },
        "example": [
          {
            "keyword": "phone",
            "location_code": 2840,
            "language_code": "en",
            "include_serp_info": true,
            "include_seed_keyword": true,
            "limit": 1
          }
        ]
      }
    ]
  },
  "example": [
    {
      "keyword": "phone",
      "location_code": 2840,
      "language_code": "en",
      "include_serp_info": true,
      "include_seed_keyword": true,
      "limit": 1
    }
  ]
}
```

## Responses

### 200 — 작업 성공

Headers:
- `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다.

**application/json**

Schema: object | null

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

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

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleKeywordSuggestionsLiveResponseInfo`

```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_DataforseoLabsGoogleKeywordSuggestionsLiveTaskInfo"
              }
            ]
          },
          "description": "<em>작업 배열</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_DataforseoLabsGoogleKeywordSuggestionsLiveResultInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleKeywordSuggestionsLiveResultInfo`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>검색 엔진 유형</em>"
    },
    "seed_keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>POST 배열의 키워드</em>"
    },
    "seed_keyword_data": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_KeywordDataInfo"
        }
      ],
      "description": "<em>시드 키워드의 키워드 데이터</em><br>이 객체의 필드는 <code>items</code> 배열의 필드와 동일합니다"
    },
    "location_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>POST 배열의 위치 코드</em><br>데이터가 없으면 값은 <code>null</code>입니다"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>POST 배열의 언어 코드</em><br>데이터가 없으면 값은 <code>null</code>입니다"
    },
    "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_DataforseoLabsGoogleKeywordSuggestionsLiveTaskInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleKeywordSuggestionsLiveTaskInfo`

```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_DataforseoLabsGoogleKeywordSuggestionsLiveResultInfo"
              }
            ]
          },
          "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>입니다: 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\" target=\"_blank\" rel=\"noopener noreferrer\">이 도움말 센터 문서</a>에서 확인하세요"
    }
  }
}
```

### 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>"
    }
  }
}
```