v0.2.0-beta

OpenAPI 3.1.0

‘Ad Traffic By Keywords’ 작업 설정

Felo API Support

MIT

서버

https://openapi.felo.ai

클라이언트 라이브러리

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO 작업

post/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post

‘Ad Traffic By Keywords’ 작업 설정

주어진 bid와 match 유형에서 keywords의 클릭수, 노출수, 지출을 예측하는 작업을 대기열에 넣고 작업 id를 반환합니다. search_partners는 Google 파트너 네트워크를 포함합니다. DataForSEO 응답 봉투로 감싸집니다. 데이터는 tasks[0].result, 처리 결과는 tasks[0].status_code에 있으며, 거부된 요청도 HTTP 200을 반환합니다. 이곳에서 실시간 변형이 없는 유일한 Google Ads 엔드포인트입니다. 예측은 항상 대기열을 거칩니다. get_dataforseo_keywords_gads_ad_traffic_fetch로 조회하세요.

가격 참고

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

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

본문

application/json

유형: array (object | null)[]
- bid
  유형: number
  
  최대 맞춤 입찰가
  필수 필드
  수집되는 데이터는 이 값을 기준으로 합니다
  광고에 지불할 의사가 있는 가격을 의미합니다. 여기에 높은 값을 지정할수록 반환되는 지표에서 더 높은 값을 얻게 됩니다
  자세한 내용은 이 도움말 센터 문서에서 확인하세요
- date_from
  유형: string
  
  예측 기간의 시작 날짜
  date_to를 지정하면 필수 필드
  date_from과 date_to를 모두 지정하면 date_interval을 지정할 필요가 없습니다
  최솟값은 내일 날짜입니다
  date_from에 지정하는 값은 date_to보다 뒤일 수 없습니다
  날짜 형식: "yyyy-mm-dd"
  예:
  "2021-10-30" Status 엔드포인트가 actual_data 필드에서 false를 반환하면 date_from을 지지난달 이전으로 설정할 수 있습니다;
  Status 엔드포인트가 actual_data 필드에서 true를 반환하면 date_from을 지난달 이전으로 설정할 수 있습니다
- date_interval
  유형: string | null
  
  예측 날짜 간격
  선택 필드
  date_interval을 지정하면 date_from과 date_to를 지정할 필요가 없습니다
  가능한 값: next_week, next_month, next_quarter
  기본값: next_month
- date_to
  유형: string
  
  예측 기간의 종료 날짜
  date_from을 지정하면 필수 필드
  date_from과 date_to를 모두 지정하면 date_interval을 지정할 필요가 없습니다
  최솟값은 date_from +1일입니다
  최댓값은 내년의 현재 일자와 월입니다
  날짜 형식: "yyyy-mm-dd"
  예:
  "2022-10-30"
- keywords
  유형: array string[]
  
  키워드
  필수 필드
  지정할 수 있는 최대 키워드 수: 1000개
  키워드 하나의 최대 문자 수: 80자
  키워드 구문 하나의 최대 단어 수: 10개
  지정한 키워드는 소문자 형식으로 변환됩니다
  참고 #1: Google Ads는 특정 키워드 그룹에 대해 데이터를 반환하지 않을 수 있습니다;
  참고 #2: Google Ads는 유사한 키워드 그룹에 대해 통합된 검색량 값을 제공합니다
  유사한 키워드의 검색량을 얻으려면 해당 키워드를 별도 요청으로 제출하는 것이 좋습니다;
  참고 #3: Google Ads는 특정 기호와 문자(예: UTF 기호, 이모지)를 허용하지 않으므로 작업을 설정할 때 사용할 수 없습니다;
  사용할 수 있는 기호와 문자에 대한 자세한 내용은 이 문서를 참고하세요
  
  DataForSEO API의 keyword 및 keywords 필드 규칙과 제한은 이 Help Center 문서에서 확인하세요
- language_code
  유형: string | null
  
  검색 엔진 언어 코드
  선택 필드
  사용 가능한 검색 엔진 언어와 해당 language_code 목록은 https://api.dataforseo.com/v3/keywords_data/google_ads/languages로 별도 요청해 받을 수 있습니다
  예:
  en
- language_name
  유형: string | null
  
  검색 엔진 언어의 전체 이름
  선택 필드
  사용 가능한 검색 엔진 언어와 해당 language_name 목록은 https://api.dataforseo.com/v3/keywords_data/google_ads/languages로 별도 요청해 받을 수 있습니다
  예:
  English
- location_code
  유형: integer | null
  
  검색 엔진 위치 코드
  선택 필드
  위치를 지정하지 않으면 전 세계 결과, 즉 사용 가능한 모든 위치의 결과를 받게 됩니다;
  이 필드를 사용하면 location_name 또는 location_coordinate를 지정할 필요가 없습니다;
  사용 가능한 검색 엔진 위치와 해당 location_code 목록은 https://api.dataforseo.com/v3/keywords_data/google_ads/locations로 별도 요청해 받을 수 있습니다
  예:
  2840
- location_coordinate
  유형: string | null
  
  위치의 GPS 좌표
  선택 필드
  위치를 지정하지 않으면 전 세계 결과, 즉 사용 가능한 모든 위치의 결과를 받게 됩니다;
  이 필드를 사용하면 location_name 또는 location_code를 지정할 필요가 없습니다;
  location_coordinate 매개변수는 "위도,경도" 형식으로 지정해야 합니다;
  데이터는 지정한 좌표가 속한 국가에 대해 제공됩니다;
  예:
  52.6178549,-155.352142
- location_name
  유형: string | null
  
  검색 엔진 위치의 전체 이름
  선택 필드
  위치를 지정하지 않으면 전 세계 결과, 즉 사용 가능한 모든 위치의 결과를 받게 됩니다;
  이 필드를 사용하면 location_code 또는 location_coordinate를 지정할 필요가 없습니다
  사용 가능한 검색 엔진 위치와 해당 location_name 목록은 https://api.dataforseo.com/v3/keywords_data/google_ads/locations로 별도 요청해 받을 수 있습니다
  예:
  London,England,United Kingdom
- match
  유형: string
  
  키워드 일치 유형
  필수 필드
  다음 값을 사용할 수 있습니다: exact, broad, phrase
- pingback_url
  유형: string | null
  
  완료된 작업의 알림 URL
  선택 필드
  작업이 완료되면 지정한 URL로 GET 요청을 보내 알립니다
  ‘$id’ 문자열을 $id 변수로, ‘$tag’를 urlencoded $tag 변수로 사용할 수 있습니다. 요청을 보내기 전에 필요한 값을 설정합니다.
  예:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  참고: pingback_url의 특수 문자는 urlencoded됩니다;
  즉, # 문자는 %23으로 인코딩됩니다
  
  자세한 내용은 Help Center를 참고하세요
- postback_url
  유형: string | null
  
  작업 결과를 보내는 URL
  선택 필드
  작업이 완료되면 결과를 gzip 형식으로 압축해 지정한 postback_url로 POST 요청을 보냅니다
  ‘$id’ 문자열을 $id 변수로, ‘$tag’를 urlencoded $tag 변수로 사용할 수 있습니다. 요청을 보내기 전에 필요한 값을 설정합니다.
  예:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  참고: postback_url의 특수 문자는 urlencoded됩니다;
  즉, # 문자는 %23으로 인코딩됩니다
  
  자세한 내용은 Help Center를 참고하세요
- sort_by
  유형: string | null
  
  결과 정렬 매개변수
  선택 필드
  이 매개변수를 사용하여 relevance, average_cpc, cost 또는 clicks 기준으로 결과를 내림차순 정렬하세요
  기본값: relevance
- tag
  유형: string | null
  
  사용자 정의 작업 식별자
  선택 필드
  최대 255자
  이 매개변수를 사용해 작업을 식별하고 결과와 매칭할 수 있습니다
  tag에 지정한 값은 응답의 data 객체에서 확인할 수 있습니다

응답

200
유형: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostResponseInfo
cost
유형: number | null 형식: double

전체 작업 비용, USD

status_code
유형: integer | null

일반 상태 코드입니다. 응답 코드 전체 목록은 여기에서 확인할 수 있습니다.

status_message
유형: string | null

일반 정보 메시지입니다. 일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다.

tasks
유형: array (object | null)[] | null

작업 배열

유형: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostTaskInfo
cost
유형: number | null 형식: double

전체 작업 비용, USD

data
유형: object | null

POST 요청에 지정한 것과 동일한 매개변수를 포함합니다

propertyName
유형: object | null
id
유형: string | null

작업 식별자 시스템 내 고유 작업 식별자(UUID 형식)

path
유형: array (string | null)[] | null

URL 경로

result
유형: object | null

결과 배열
이 경우 값은 null입니다

result_count
유형: integer | null 형식: int64

result 배열의 요소 수

status_code
유형: integer | null

작업의 상태 코드 DataForSEO가 생성하며 10000-60000 범위일 수 있습니다. 응답 코드 전체 목록은 여기에서 확인할 수 있습니다.

status_message
유형: string | null

작업의 정보 메시지 일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다.

time
유형: string | null

실행 시간, 초

tasks_count
유형: integer | null 형식: int64

tasks 배열의 작업 수

tasks_error
유형: integer | null 형식: int64

오류와 함께 반환된 tasks 배열의 작업 수

time
유형: string | null

총 실행 시간(초)

version
유형: string | null

API의 현재 버전
application/json
400

요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.
401

유효한 Felo API 키가 필요합니다.
402

청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.
403

이 계정에는 이 작업을 수행할 권한이 없습니다.
429

요청 또는 지출 한도에 도달했습니다.
502

서비스가 요청을 완료할 수 없습니다.
503

API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.
504

요청을 처리하는 동안 서비스 시간이 초과되었습니다.
default

오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.

application/json

post/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "bid": 999,
    "match": "exact",
    "keywords": [
      "seo marketing"
    ]
  }
]'

스키마 표시

{
  "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": null
    }
  ]
}

작업 성공

도움이 필요하신가요?

API, 결제, 계정 관련 문의는 지원에서 안내해 드립니다.
Discord에서 Felo 개발자와 대화해 보세요.
변경 내역을 확인해 보세요.
대량 구매 가격이나 구매 관련 도움이 필요하신가요? 영업팀 문의.
LLM으로 구축 중이신가요? llms.txt를 읽어 보세요.

‘Ad Traffic By Keywords’ 작업 설정

인증Required

DataForSEO

‘Ad Traffic By Keywords’ 작업 설정

가격 참고

도움이 필요하신가요?