DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
SERP 경쟁사
keywords 집합에서 함께 순위에 오르는 도메인과 공유 키워드 수를 보여줍니다. se_type, seed_keywords, total_count, items_count, items를 반환합니다. DataForSEO 응답 봉투로 감싸집니다. 데이터는 tasks[0].result, 처리 결과는 tasks[0].status_code에 있으며, 거부된 요청도 HTTP 200을 반환합니다. ⚠️ 이들은 공유 순위로 결정되는 검색 경쟁사입니다. 링크 그래프 기준 대응은 post_dataforseo_backlinks_competitors_live이며, 두 목록은 자주 다르며 그 자체가 유용한 정보입니다.
가격 참고
- 과금 기준: 보고된 응답 비용.
- 참고 요청 추정치: USD 0.0192.
- 참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요.
참고용 메타데이터일 뿐이며, 계정 견적, 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.
- 유형: array (object | null)[]
- filters유형: array (object | null)[] | null
결과 필터링 매개변수 배열
선택 필드
한 번에 여러 필터를 추가할 수 있습니다(최대 8개)
조건 사이에 논리 연산자and,or를 설정해야 합니다
지원되는 연산자:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,match,not_match,ilike,not_ilike,like,not_like%연산자는like및not_like,ilike및not_ilike와 함께 사용해 0자 이상의 임의 문자열을 일치시킬 수 있습니다
예시:["median_position","in",[1,10]][["median_position","in",[1,10]],"and",["domain","not_like","%wikipedia.org%"]][["domain","not_like","%wikipedia.org%"],
"and",
[["relevant_serp_items",">",0],"or",["median_position","in",[1,10]]]]
필터에 대한 자세한 내용은 Dataforseo Labs - Filters 또는 도움말 센터 가이드를 참조하세요빈 객체 - include유형: boolean | null
_subdomains 검색에 서브도메인 포함 여부
선택 필드false로 설정하면 서브도메인은 무시됩니다
기본값:true - item유형: array string[] | null
_types 검색 결과 유형
응답에 포함되는 검색 결과 유형을 나타냅니다
선택 필드가능한 값:
["organic", "paid", "featured_snippet", "local_pack"]
기본값:["organic", "paid"] - keywords유형: array string[]
- language유형: string | null
_code 고유 언어 식별자
language_name을 지정하지 않으면 필수 필드
참고:language_name또는language_code중 하나를 지정해야 합니다language_code매개변수로 사용 가능한 언어 목록은 별도 요청으로 받을 수 있습니다https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
예시:en - language유형: string
_name 언어의 전체 이름
language_code를 지정하지 않으면 필수 필드
참고:language_name또는language_code중 하나를 지정해야 합니다language_name매개변수로 사용 가능한 언어 목록은 별도 요청으로 받을 수 있습니다https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
예시:English - limit유형: integer | null
반환되는 최대 도메인 수
선택 필드
기본값:100
최댓값:1000 - location유형: integer
_code 고유 위치 식별자
location_name을 지정하지 않으면 필수 필드
참고:location_name또는location_code중 하나를 지정해야 합니다location_code매개변수로 사용 가능한 위치 목록은 별도 요청으로 받을 수 있습니다https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
예시:2840 - location유형: string
_name 위치의 전체 이름
location_code를 지정하지 않으면 필수 필드
참고:location_name또는location_code중 하나를 지정해야 합니다location_name매개변수로 사용 가능한 위치 목록은 별도 요청으로 받을 수 있습니다https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
예시:United Kingdom - offset유형: integer | null
반환되는 도메인의 결과 배열에서의 오프셋
선택 필드
기본값:010값을 지정하면 결과 배열의 처음 열 도메인을 건너뛰고 그다음 도메인부터 데이터를 제공합니다 - order유형: array string[] | null
_by 결과 정렬 규칙
선택 필드filters배열과 동일한 값을 사용해 결과를 정렬할 수 있습니다
가능한 정렬 유형:asc- 결과를 오름차순으로 정렬합니다desc- 결과를 내림차순으로 정렬합니다
쉼표를 구분자로 사용합니다
예시:["avg_position,asc"]
기본 규칙:["rating,desc"]
한 요청에는 정렬 규칙을 최대 3개까지만 설정할 수 있습니다.
여러 정렬 규칙은 쉼표로 구분해야 합니다
예시:["avg_position,asc","etv,desc"] - tag유형: string | null
사용자 정의 작업 식별자
선택 필드
최대 255자
이 매개변수를 사용해 작업을 식별하고 결과와 매칭할 수 있습니다tag에 지정한 값은 응답의data객체에서 확인할 수 있습니다
- 유형: object | null · Response36Afe1097B20_DataforseoLabsGoogleSerpCompetitorsLiveResponseInfo200
- 유형: number | null 형식: doublecost
전체 작업 비용, USD
- 유형: integer | nullstatus
_code 일반 상태 코드입니다. 응답 코드 전체 목록은 여기에서 확인할 수 있습니다.
- 유형: string | nullstatus
_message 일반 정보 메시지입니다. 일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다.
- 유형: array (object | null)[] | nulltasks
작업 배열
- 유형: object | null · Response36Afe1097B20_DataforseoLabsGoogleSerpCompetitorsLiveTaskInfo
- cost유형: number | null 형식: double
전체 작업 비용, USD
- data유형: object | null
POST 요청에 지정한 것과 동일한 매개변수를 포함합니다
- property유형: object | null
Name
- id유형: string | null
작업 식별자 시스템 내 고유 작업 식별자(UUID 형식)
- path유형: array (string | null)[] | null
URL 경로
- result유형: array (object | null)[] | null
결과 배열
- items유형: array (object | null)[] | null
감지된 SERP 경쟁사 및 관련 데이터를 포함합니다
- avg유형: number | null 형식: float
_position 지정된 키워드에 대한 도메인의 평균 위치
keywords_positions배열 값의 산술 평균 - domain유형: string | null
감지된 SERP 경쟁사의 도메인 이름
- etv유형: number | null
- keywords유형: integer | null 형식: int64
_count 도메인이 SERP에서 위치를 가지는 지정된 키워드 수
- keywords유형: object | null
_positions 키워드 위치
관련 도메인이 지정된 키워드에 대해 SERP에서 차지하는 SERP 위치- property유형: array (integer | null)[] | null
Name
- median유형: number | null
_position 지정된 키워드에 대한 도메인의 중앙값 위치
keywords_positions배열 값의 중앙값 - rating유형: number | null
가능한 최대 키워드 위치와 실제 키워드 위치의 차이
지정된 키워드에 대한 SERP에서 도메인의 상대적 가시성 비율을 나타냅니다
sum(100-keywords_positions)로 계산됩니다 - relevant유형: integer | null
_serp _items 도메인과 관련된 SERP 요소 수
지정된 키워드에 대해 도메인과 관련된 SERP 내 검색 결과 수를 나타냅니다 - se유형: string | null
_type 검색 엔진 유형
- visibility유형: number | null
SERP 가시성 비율
지정된 키워드의 SERP 위치를 기준으로 웹사이트 가시성 비율을 나타냅니다
110범위의 위치를 가진 키워드에는 각각 10.1의 가시성 지수가 부여됩니다
1120범위의 위치를 가진 키워드는 0.05의 고정 가시성 지수를 가집니다
20100 위치의 키워드는 가시성 지수가 0입니다
- items유형: integer | null 형식: int64
_count items배열에 반환된 결과 수 - language유형: string | null
_code POST 배열의 언어 코드
데이터가 없으면 값은null입니다 - location유형: integer | null
_code POST 배열의 위치 코드
데이터가 없으면 값은null입니다 - se유형: string | null
_type 검색 엔진 유형
- seed유형: array (string | null)[] | null
_keywords 요청에 지정된 키워드
키워드는 디코딩된 %##로 반환됩니다('+' 문자는 공백 문자로 디코딩됩니다) - total유형: integer | null 형식: int64
_count 데이터베이스에서 요청과 관련된 총 결과 수
- result유형: integer | null 형식: int64
_count result 배열의 요소 수
- status유형: integer | null
_code 작업의 상태 코드 DataForSEO가 생성하며 10000-60000 범위일 수 있습니다. 응답 코드 전체 목록은 여기에서 확인할 수 있습니다.
- status유형: string | null
_message 작업의 정보 메시지 일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다.
- time유형: string | null
실행 시간, 초
- 유형: integer | null 형식: int64tasks
_count tasks 배열의 작업 수
- 유형: integer | null 형식: int64tasks
_error 오류와 함께 반환된 tasks 배열의 작업 수
- 유형: string | nulltime
총 실행 시간(초)
- 유형: string | nullversion
API의 현재 버전
application/json - 400
요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.
- 401
유효한 Felo API 키가 필요합니다.
- 402
청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.
- 403
이 계정에는 이 작업을 수행할 권한이 없습니다.
- 429
요청 또는 지출 한도에 도달했습니다.
- 502
서비스가 요청을 완료할 수 없습니다.
- 503
API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.
- 504
요청을 처리하는 동안 서비스 시간이 초과되었습니다.
- default
오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/serp_competitors/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keywords": [
"phone"
],
"language_name": "English",
"location_code": 2840,
"item_types": [
"organic"
],
"limit": 5
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"se_type": null,
"seed_keywords": [
null
],
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"domain": null,
"avg_position": null,
"median_position": null,
"rating": null,
"etv": null,
"keywords_count": null,
"visibility": null,
"relevant_serp_items": null,
"keywords_positions": null
}
]
}
]
}
]
}