# 도메인 순위 개요
**API:** Data API
**Endpoint:** `POST /v1/beta/dataforseo/dataforseo_labs/google/domain_rank_overview/live`
**Tags:** DataForSEO
`location_code`별 도메인의 검색 영향력입니다: 자연 및 유료 키워드 수, 예상 트래픽, 트래픽 가치. `se_type`, `target`, `total_count`, `items_count`, `items`를 반환합니다. DataForSEO 응답 봉투로 감싸집니다. 데이터는 `tasks[0].result`에, 결과는 `tasks[0].status_code`에 있으며, 거부된 요청도 여전히 HTTP 200을 반환합니다. 시간에 따른 같은 수치는 `post_dataforseo_labs_google_historical_rank_live`, 여러 도메인을 한 번에 보려면 `post_dataforseo_labs_google_bulk_traffic_estimation_live`를 사용하세요.
### 가격 참고
- 과금 기준: 응답에 보고된 비용.
- 참고 요청 추정치: USD 0.0121.
- 참고 고객 배수: 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": {
"target": {
"type": "string",
"description": "도메인
필수 필드
대상 웹사이트의 도메인 이름
도메인은 https://와 www. 없이 지정해야 합니다"
},
"location_name": {
"type": [
"string",
"null"
],
"description": "위치의 전체 이름
선택 필드
이 필드를 사용하면 location_code를 지정할 필요가 없습니다
사용 가능한 위치와 해당 location_name 목록은
https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages에 별도 요청을 보내 받을 수 있습니다
모든 사용 가능한 위치의 결과를 얻으려면 이 필드를 무시하세요
예시:
United Kingdom"
},
"location_code": {
"type": [
"integer",
"null"
],
"description": "위치 코드
선택 필드
이 필드를 사용하면 location_name을 지정할 필요가 없습니다
사용 가능한 위치와 해당 location_code 목록은
https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages에 별도 요청을 보내 받을 수 있습니다
모든 사용 가능한 위치의 결과를 얻으려면 이 필드를 무시하세요
예시:
2840"
},
"language_name": {
"type": [
"string",
"null"
],
"description": "언어의 전체 이름
선택 필드
이 필드를 사용하면 language_code를 지정할 필요가 없습니다
사용 가능한 언어와 해당 language_name 목록은
https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages에 별도 요청을 보내 받을 수 있습니다
모든 사용 가능한 언어의 결과를 얻으려면 이 필드를 무시하세요
예시:
English"
},
"language_code": {
"type": [
"string",
"null"
],
"description": "언어 코드
선택 필드
이 필드를 사용하면 language_name을 지정할 필요가 없습니다
사용 가능한 언어와 해당 language_code 목록은
https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages에 별도 요청을 보내 받을 수 있습니다
모든 사용 가능한 언어의 결과를 얻으려면 이 필드를 무시하세요
예시:
en"
},
"ignore_synonyms": {
"type": [
"boolean",
"null"
],
"description": "유사도가 높은 키워드 무시
선택 필드
true로 설정하면 유사도가 높은 키워드는 순위 및 트래픽 계산에서 모두 제외되며, 결과는 동의어 그룹의 주요 키워드 데이터를 기반으로 합니다
기본값: false"
},
"limit": {
"type": [
"integer",
"null"
],
"description": "도메인당 반환되는 최대 결과 수
선택 필드
기본값: 100
최댓값: 1000"
},
"offset": {
"type": [
"integer",
"null"
],
"description": "반환된 항목의 결과 배열에서의 오프셋
선택 필드
기본값: 0
10 값을 지정하면 결과 배열의 처음 열 개 items를 건너뛰고 이후 항목에 대한 데이터가 제공됩니다"
},
"tag": {
"type": [
"string",
"null"
],
"description": "사용자 정의 작업 식별자
선택 필드
최대 255자
이 매개변수를 사용해 작업을 식별하고 결과와 매칭할 수 있습니다
tag에 지정한 값은 응답의 data 객체에서 확인할 수 있습니다"
}
},
"example": [
{
"target": "dataforseo.com",
"language_name": "English",
"location_code": 2840
}
]
}
]
},
"example": [
{
"target": "dataforseo.com",
"language_name": "English",
"location_code": 2840
}
]
}
```
## Responses
### 200 — 작업 성공
Headers:
- `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다.
**application/json**
Schema: object | null
```json
{
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveResponseInfo"
}
]
}
```
### 400 — 요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.
### 401 — 유효한 Felo API 키가 필요합니다.
### 402 — 청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.
### 403 — 이 계정에는 이 작업을 수행할 권한이 없습니다.
### 429 — 요청 또는 지출 한도에 도달했습니다.
### 502 — 서비스가 요청을 완료할 수 없습니다.
### 503 — API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.
### 504 — 요청을 처리하는 동안 서비스 시간이 초과되었습니다.
### default — 오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.
**application/json**
Schema:
```json
{}
```
## Schema definitions
### Response36Afe1097B20_BaseResponseInfo
`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`
```json
{
"properties": {
"version": {
"type": [
"string",
"null"
],
"description": "API의 현재 버전"
},
"status_code": {
"type": [
"integer",
"null"
],
"description": "일반 상태 코드입니다.\n응답 코드 전체 목록은 여기에서 확인할 수 있습니다."
},
"status_message": {
"type": [
"string",
"null"
],
"description": "일반 정보 메시지입니다.\n일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다."
},
"time": {
"type": [
"string",
"null"
],
"description": "총 실행 시간(초)"
},
"cost": {
"type": [
"number",
"null"
],
"description": "전체 작업 비용, 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_DataforseoLabsGoogleDomainRankOverviewLiveItem
`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveItem`
```json
{
"type": "object",
"properties": {
"se_type": {
"type": [
"string",
"null"
],
"description": "검색 엔진 유형"
},
"location_code": {
"type": [
"integer",
"null"
],
"description": "POST 배열의 위치 코드"
},
"language_code": {
"type": [
"string",
"null"
],
"description": "POST 배열의 언어 코드"
},
"metrics": {
"type": [
"object",
"null"
],
"additionalProperties": {
"$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsMetricsInfo"
},
"description": "지정된 도메인과 관련된 순위 데이터"
}
}
}
```
### Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveResponseInfo
`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveResponseInfo`
```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_DataforseoLabsGoogleDomainRankOverviewLiveTaskInfo"
}
]
},
"description": "작업 배열"
}
}
}
]
}
```
### Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveResultInfo
`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveResultInfo`
```json
{
"type": "object",
"properties": {
"se_type": {
"type": [
"string",
"null"
],
"description": "검색 엔진 유형"
},
"target": {
"type": [
"string",
"null"
],
"description": "POST 배열의 대상 도메인"
},
"location_code": {
"type": [
"integer",
"null"
],
"description": "POST 배열의 위치 코드"
},
"language_code": {
"type": [
"string",
"null"
],
"description": "POST 배열의 언어 코드"
},
"total_count": {
"type": [
"integer",
"null"
],
"description": "요청과 관련해 데이터베이스에 있는 총 결과량",
"format": "int64"
},
"items_count": {
"type": [
"integer",
"null"
],
"description": "items 배열에 반환된 결과 수",
"format": "int64"
},
"items": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveItem"
}
]
},
"description": "순위 및 트래픽 데이터를 포함합니다"
}
}
}
```
### Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveTaskInfo
`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveTaskInfo`
```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_DataforseoLabsGoogleDomainRankOverviewLiveResultInfo"
}
]
},
"description": "결과 배열"
}
}
}
]
}
```
### Response36Afe1097B20_DataforseoLabsMetricsInfo
`#/components/schemas/Response36Afe1097B20_DataforseoLabsMetricsInfo`
```json
{
"type": "object",
"properties": {
"pos_1": {
"type": [
"integer",
"null"
],
"description": "도메인 또는 하위 도메인이 #1 순위를 차지한 자연 검색 SERP 수"
},
"pos_2_3": {
"type": [
"integer",
"null"
],
"description": "도메인 또는 하위 도메인이 #2-3 순위를 차지한 자연 검색 SERP 수"
},
"pos_4_10": {
"type": [
"integer",
"null"
],
"description": "도메인 또는 하위 도메인이 #4-10 순위를 차지한 자연 검색 SERP 수"
},
"pos_11_20": {
"type": [
"integer",
"null"
],
"description": "도메인 또는 하위 도메인이 #11-20 순위를 차지한 자연 검색 SERP 수"
},
"pos_21_30": {
"type": [
"integer",
"null"
],
"description": "도메인 또는 하위 도메인이 #21-30 순위를 차지한 자연 검색 SERP 수"
},
"pos_31_40": {
"type": [
"integer",
"null"
],
"description": "도메인 또는 하위 도메인이 #31-40 순위를 차지한 자연 검색 SERP 수"
},
"pos_41_50": {
"type": [
"integer",
"null"
],
"description": "도메인 또는 하위 도메인이 #41-50 순위를 차지한 자연 검색 SERP 수"
},
"pos_51_60": {
"type": [
"integer",
"null"
],
"description": "도메인 또는 하위 도메인이 #51-60 순위를 차지한 자연 검색 SERP 수"
},
"pos_61_70": {
"type": [
"integer",
"null"
],
"description": "도메인 또는 하위 도메인이 #61-70 순위를 차지한 자연 검색 SERP 수"
},
"pos_71_80": {
"type": [
"integer",
"null"
],
"description": "도메인 또는 하위 도메인이 #71-80 순위를 차지한 자연 검색 SERP 수"
},
"pos_81_90": {
"type": [
"integer",
"null"
],
"description": "도메인 또는 하위 도메인이 #81-90 순위를 차지한 자연 검색 SERP 수"
},
"pos_91_100": {
"type": [
"integer",
"null"
],
"description": "도메인 또는 하위 도메인이 #91-100 순위를 차지한 자연 검색 SERP 수"
},
"etv": {
"type": [
"number",
"null"
],
"description": "예상 트래픽 규모
도메인 또는 하위 도메인에 대한 예상 월간 자연 검색 트래픽
도메인 또는 하위 도메인이 순위를 가지는 카테고리의 모든 키워드에 대한 CTR(클릭률)과 검색량 값을 곱한 값으로 계산됩니다
지표 계산 방법은 이 도움말 센터 문서에서 확인하세요"
},
"count": {
"type": [
"integer",
"null"
],
"description": "도메인 또는 하위 도메인을 포함하는 자연 검색 SERP의 총 개수",
"format": "int64"
},
"estimated_paid_traffic_cost": {
"type": [
"number",
"null"
],
"description": "자연 검색 트래픽을 유료로 전환하는 예상 비용
도메인 또는 하위 도메인이 순위를 가지는 카테고리의 모든 키워드로 광고를 집행하는 예상 월간 비용(USD)을 나타냅니다
이 지표는 자연 검색 etv와 유료 cpc 값을 곱한 값으로 계산되며, Google 검색에서 PPC 광고를 통해 예상 월간 자연 검색 트래픽 규모를 유도하는 비용을 나타냅니다
지표 계산 방법은 이 도움말 센터 문서에서 확인하세요"
},
"is_new": {
"type": [
"integer",
"null"
],
"description": "신규 순위 요소 수
지정된 대상에 대해 발견된 신규 순위 요소 수를 나타냅니다"
},
"is_up": {
"type": [
"integer",
"null"
],
"description": "순위 상승
지정된 대상의 순위 요소 중 몇 개가 상승했는지 나타냅니다"
},
"is_down": {
"type": [
"integer",
"null"
],
"description": "순위 하락
지정된 대상의 순위 요소 중 몇 개가 하락했는지 나타냅니다"
},
"is_lost": {
"type": [
"integer",
"null"
],
"description": "손실된 순위 요소
지정된 대상의 순위 요소 중 이전에 SERP에 표시되었으나 마지막 확인 시 발견되지 않은 요소의 수를 나타냅니다"
},
"clickstream_etv": {
"type": [
"number",
"null"
],
"description": "클릭스트림 데이터 기반 예상 트래픽 규모
도메인이 순위를 가지는 모든 키워드의 클릭률과 클릭스트림 검색량 값을 곱한 값으로 계산됩니다
이 필드의 결과를 가져오려면 include_clickstream_data 매개변수를 true로 설정해야 합니다
지표 계산 방법은 이 도움말 센터 문서에서 확인하세요",
"format": "double"
},
"clickstream_gender_distribution": {
"type": [
"object",
"null"
],
"additionalProperties": {
"type": [
"integer",
"null"
],
"format": "int64"
},
"description": "성별별 예상 클릭스트림 기반 지표 분포
이 필드의 결과를 가져오려면 include_clickstream_data 매개변수를 true로 설정해야 합니다
지표 계산 방법은 이 도움말 센터 문서에서 확인하세요"
},
"clickstream_age_distribution": {
"type": [
"object",
"null"
],
"additionalProperties": {
"type": [
"integer",
"null"
],
"format": "int64"
},
"description": "연령별 클릭스트림 기반 지표 분포
이 필드의 결과를 가져오려면 include_clickstream_data 매개변수를 true로 설정해야 합니다
지표 계산 방법은 이 도움말 센터 문서에서 확인하세요"
}
}
}
```