prompts[]는 추천 순서이고, brands[]는 같은 분야에서
어떤 브랜드가 검색 수요를 모으는지 보여줍니다. 찾은 프롬프트는 콘텐츠를 기획하거나, 답변 엔진에
직접 묻거나, GEO 모니터로 답변을 추적하는 데 씁니다.
프롬프트를 찾는 방법
- 제품 종류. 해당 시장의 키워드 데이터에서 사람들이 이 주제 아래 검색하는 제품 종류를 찾습니다. 예를 들어
선크림아래의선스틱입니다. 결과의cores[]가 이것입니다. - 조건. 종류마다 피부 타입, 가격대, 팀 규모처럼 구매자의 선택을 좁히는 질문을 찾습니다. 결과의
cores[].questions가 이것입니다. 그 선택지가 조건이 되고, 사람들이 검색하는 변형(톤업 선크림,남자 선크림)도 조건이 됩니다. - 프롬프트. 조건을
depth까지 조합해 프롬프트를 만듭니다. 프롬프트마다 측정하거나 추정한 검색수를 붙이고, 추천 순서로 정렬합니다.
리서치 태스크 제출
GET /v1/async/task/{id}로 읽거나, 요청에 webhook.url을 넣어 태스크가 끝날 때 받습니다.
다른 비동기 태스크와 똑같이 동작하며 결과는 response에 들어 있습니다.
요청 스키마는 API 레퍼런스에 있습니다.
Prompt Research는
POST /v1/prompt-research로만 제출합니다. POST /v1/async/task는
taskType: "PROMPT_RESEARCH"를 거절합니다.요청 필드
본문은 평평한 구조입니다. 리서치 필드와 태스크 옵션이 모두 최상위에 놓입니다.시장
US는 프롬프트를 영어로 씁니다. 수요는 최근 12개월의 월평균이므로 (demandSource.period: "monthly_average_last_12_months"), 계절을 타는 검색어는 성수기에 그 달의 검색수보다 낮게 나옵니다.KR은 프롬프트를 한국어로 씁니다. 수요는 최근 30일 기준입니다 (demandSource.period: "last_30_days"). 시드는 한국어 검색 데이터와 대조되므로 한국 사용자가 검색하는 표기 그대로 보내세요.
language는 US이면 en, KR이면 ko입니다.
깊이
depth는 프롬프트 하나가 조합하는 조건의 수를 정합니다. 그 값까지의 모든 깊이가 prompts에 나옵니다.
한 질문의 선택지는 서로 대안입니다. 그래서 지성 피부는 가격대와 함께 묶일 수 있지만 건성 피부와는 묶이지 않습니다.
깊이마다 프롬프트가 하나 이상 있어야 하므로
limit은 depth + 1 이상이어야 합니다. depth: 0은 종류마다
기본 요청과 사람들이 이 주제에 대해 검색하는 질문을 돌려줍니다.
결과 읽기
예를 들어 한국에서선크림을 실행하면 다음과 같은 결과가 나옵니다. 몇 항목만 남겼습니다.
prompts[]
추천 순서로 정렬한 프롬프트이며 최대 limit개입니다. 코어마다 기본 요청과 가격대 두 개가 먼저 오고, 그
뒤로는 여러 깊이에 걸쳐 수요 순으로 이어집니다. 모든 코어의 기본 요청이 가장 먼저 오고, 그다음부터 코어들이 검색수에
비례해 번갈아 들어갑니다. 그래서 목록의 앞부분만 잘라도 전체와 같은 비율로 나뉩니다. 주제를 알아보려고 묻는
질문(intent: "informational")은 리서치가 찾으면 목록의 5분의 1쯤을 차지합니다. 구매자가 고르기 전에 묻는
질문이기 때문입니다. 수요 순으로만 보려면 monthlySearchVolume으로 정렬하세요.
cores[]
조사한 제품 종류입니다. 시드 자체의 종류가 먼저 옵니다. 원하는 종류를 조사하려면 요청에 cores를 보내세요.
brands[]와 그 밖의 필드
brands[]는 이 분야에서 사람들이 검색하는 브랜드, 제조사, 제품 라인과 그 monthlySearchVolume입니다.
프롬프트에는 브랜드명을 넣지 않으므로 이 수요는 prompts에 들어가지 않습니다. 내 브랜드와 비교할 경쟁사로 쓰세요.
브랜드 기준으로 프롬프트 평가하기
brand와 brandDescription을 함께 보내면 프롬프트마다 fit이 붙습니다.
core: 프롬프트가 묻는 것을 브랜드가 제공한다고 설명에 있습니다.related: 설명에 언급되지 않은 모든 것입니다.
limit보다 적을 수
있습니다. fit은 브랜드가 답할 수 있는 프롬프트를 앞으로 올리며, 수요 숫자는 그대로입니다.
fit이 붙습니다.
related가 됩니다. 특정 하위 주제를 결과에서
아예 빼려면 exclude를 쓰세요.
리서치에서 모니터로
이 프롬프트에 대한 AI 답변이 내 브랜드를 얼마나 자주 언급하는지 추적하려면prompts[]를
POST /v1/monitors에 넣습니다. 아래 예시는 완료된
리서치 태스크를 가져와 프롬프트를 모니터 프롬프트로, 상위 10개 brands[]를 경쟁사로 쓰고(브랜드 모니터는 최대
10개까지 받습니다) 매일 도는 브랜드 모니터를 만듭니다.
tasksPerRun 한도(셀프서브 계정은 200, GET /v1/monitors/capabilities에서 내 한도 확인)까지만 태스크를
큐에 넣을 수 있고, 엔진마다 프롬프트 × 위치 지점 × samples로 셉니다. 프롬프트 40개를 엔진 5개에서 위치 지점
하나, 샘플 하나로 돌리면 태스크 200개입니다.
카테고리 모니터라면 "mode": "CATEGORY"와 category를 보내고, 리서치에 코어가 둘 이상이면 promptTopics에서
프롬프트마다 core를 연결하세요. 두 종류와 전체 요청은 모니터를 참고하세요.
숫자 읽는 법
- 깊이 0과 1은 측정값입니다. 기본 요청에는 그 종류의 검색수가, 조건이 하나인 프롬프트에는 그 키워드
(
conditions[0].keyword)의 검색수가 붙습니다. - 깊이 2 이상은 추정값입니다. 조건이 둘 이상인 프롬프트는 그대로 검색되는 일이 드물어 숫자를 추정합니다
(
volumeBasis: "estimated"). 추정값은 프롬프트의 순위를 정하는 데 쓰세요. - 넓은 프롬프트는 좁은 프롬프트를 포함합니다. 선크림 검색수에는 톤업 선크림 검색수가 들어 있으므로 프롬프트끼리 숫자를 더하지 마세요.
- 월 10회 미만은
null입니다.volumeReason이 이유를 알려줍니다.not_searched는 아무도 그 조건을 검색하지 않는 경우,part_not_searched는 조건 중 하나가 검색되지 않는 경우,estimate_below_floor는 추정값이 10 미만인 경우입니다.cores[].questions의 선택지는 아무도 검색하지 않아도 결과에 남으므로, 기업용 제품을 리서치하면null프롬프트가 많이 나올 수 있습니다. - 숫자는 검색 수요입니다.
demandSource.period동안 해당 시장에서 각 프롬프트 뒤의 필요를 검색한 수입니다.
오류와 과금
완료된 태스크당 14크레딧입니다. 실패한 태스크는 과금되지 않습니다. 크레딧과 한도를 참고하세요.제출 시 거절
실패한 태스크
실패한 태스크는status: "FAILED"이고, error 문자열이 코드로 시작합니다.
다음 단계
GEO 모니터
찾은 프롬프트를 여러 AI 엔진에서 일정에 따라 추적합니다.