DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
ID로 ‘Ads Traffic By Keywords’ 결과 조회
id로 대기 중인 Google Ads 트래픽 예측 작업을 조회합니다. 지정한 입찰가에 대한 예상 노출수, 클릭수, 비용, 평균 게재순위를 제공합니다. DataForSEO 응답 봉투로 감싸집니다. 데이터는 tasks[0].result, 처리 결과는 tasks[0].status_code에 있으며, 거부된 요청도 HTTP 200을 반환합니다. 검색량 엔드포인트와 달리 측정값이 아니라 예측값이며, 수치는 bid와 match에 따라 달라집니다.
가격 참고
- 과금 기준: 보고된 응답 비용.
- 참고 요청 추정치: USD 0.012.
- 참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요.
참고용 메타데이터일 뿐이며, 계정 견적, 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.
- 유형: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetResponseInfo200
- 유형: number | null 형식: doublecost
전체 작업 비용, USD
- 유형: integer | nullstatus
_code 일반 상태 코드입니다. 응답 코드 전체 목록은 여기에서 확인할 수 있습니다.
- 유형: string | nullstatus
_message 일반 정보 메시지입니다. 일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다.
- 유형: array (object | null)[] | nulltasks
작업 배열
- 유형: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetTaskInfo
- 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
결과 배열
- average유형: number | null 형식: double
_cpc 평균 클릭당 비용 값
지정된 기간과 과거 데이터를 기반으로 키워드에 대해 추정한 클릭당 비용(USD)을 나타냅니다.
데이터가 없으면 값은_nulln - bid유형: number | null
최대 맞춤 입찰가
작업을 설정할 때 지정한 입찰가
광고에 지불할 의사가 있는 금액을 나타냅니다
지정한 값이 높을수록 응답에서 더 높은 지표와 비용을 받게 됩니다
이 도움말 센터 문서에서 자세히 알아보세요 - clicks유형: number | null
광고 클릭수
지정된 기간 내에 광고가 받을 것으로 예상되는 클릭 수
데이터가 없으면 값은_nulln - cost유형: number | null
광고 비용
지정된 기간 내에 광고를 실행하는 데 청구될 금액
데이터가 없으면 값은_nulln - ctr유형: number | null 형식: double
광고의 예상 클릭률(CTR)
광고가 받을 것으로 예상되는 클릭 수를 광고 노출 수로 나눈 값
참고: 매개변수가 지원 중단되어 값은 항상null입니다 - date유형: string | null
_interval POST 배열의 예측 날짜 간격
- impressions유형: integer | null
예상 광고 노출수
지정된 기간 내에 광고가 받을 것으로 예상되는 노출 수
참고: 매개변수가 지원 중단되어 값은 항상_nulln - keyword유형: string | null
POST 배열의 키워드
POST 배열에 지정된 모든 키워드에 대해 지표가 제공됩니다 - language유형: string | null
_code POST 배열의 언어 코드
데이터가 없으면 값은null입니다 - location유형: integer | null
_code POST 배열의 위치 코드
데이터가 없으면 값은null입니다 - match유형: string | null
키워드 일치 유형
다음 값을 사용할 수 있습니다:exact,broad,phrase - search유형: boolean | null
_partners Google 검색 파트너 포함
값은 항상false입니다
- 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/keywords_data/google_ads/ad_traffic_by_keywords/task_get/00000000-0000-0000-0000-000000000000 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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": [
{
"keyword": null,
"location_code": null,
"language_code": null,
"date_interval": null,
"search_partners": null,
"bid": null,
"match": null,
"impressions": null,
"ctr": null,
"average_cpc": null,
"cost": null,
"clicks": null
}
]
}
]
}