이제 ChatGPT, Gemini, Google에서 중국 본토를 지원해요
CHATGPT, GEMINI, GOOGLE 태스크의 country를 CN이나 HK로 정해 중국 본토와 홍콩 사용자가 보는 답변을 받으세요.
Prompt Research는 주제 하나를 사람들이 AI 어시스턴트에 실제로 묻는 질문으로 바꾸고, 각 질문에 담긴 필요의 월간 검색 수요 순으로 정렬해요.
받는 결과
prompts: 사람들이 AI 어시스턴트에 묻는 말투로 쓴 질문 최대 50개입니다. 수요가 큰 순서로 오고, 질문마다 월간 검색량과 주제 전체 수요에서 차지하는 비중이 붙습니다.- 질문마다 세부 주제, 페르소나, 의도, 구매 단계가 붙어 세부분야와 구매 단계별로 묶어 볼 수 있습니다.
monitorSet: GEO 모니터가 추적할 질문을 넣을 순서대로 담습니다.brands: 같은 분야에서 검색 수요를 모으는 경쟁 브랜드입니다.
동작 방식
“선크림” 같은 주제와 시장을 보내면 Prompt Research가 그 시장에서 이 주제에 모인 월간 검색 수요를 측정합니다. KR은 최근 30일, US는 최근 12개월의 월평균입니다. 사람들이 가장 많이 찾는 필요를 찾아 AI 어시스턴트에게 묻는 질문 형태로 바꿉니다. KR은 한국어, US는 영어 질문을 돌려주며 대부분 30~60초 안에 끝납니다.
브랜드와 브랜드 설명을 함께 보내면 질문마다 적합도(fit)가 붙습니다. 브랜드 이름이 들어간 질문은 결과에서 빠지므로, 이 질문으로 만든 모니터는 브랜드가 스스로 얻은 언급을 측정합니다.
Playground의 프롬프트 리서치 탭과 새 모니터 화면도 같은 리서치를 실행합니다.
요청 보내기
API 키를 Authorization 헤더에 넣어 요청을 보냅니다.
curl -X POST https://api.querying.ai/v1/prompt-research \
-H "Authorization: Bearer $QUERYING_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "seed": "wireless earbuds", "country": "US", "limit": 20 }'요청 필드
seedstring필수- 주제입니다. 글자, 숫자, 한 칸 띄어쓰기로 1~30자. 예:
선크림. countrystring필수KR또는US. 프롬프트는 그 시장의 언어로 나옵니다.limitinteger- 돌려받을 프롬프트 수, 1~50. 기본값 20.
excludearray- 최대 20개 단어. 이 단어가 들어간 프롬프트는 결과에서 빠집니다.
monitorSizeintegermonitorSet에 담을 프롬프트 수, 1~50. 기본값 20.monitorEnginesarray- 모니터가 실행할 엔진입니다.
monitorSize가 모니터 한도인 프롬프트 × 엔진 200개 안에 들도록 확인합니다. brandstring- 내 브랜드입니다. 브랜드 이름이 들어간 프롬프트는 결과에서 빠지므로 모든 프롬프트가 실제 수요를 측정합니다.
brandDescriptionstring- 브랜드가 무엇을 누구에게 파는지 최대 500자로 씁니다. 프롬프트마다
fit이 붙고 내 브랜드가 답할 프롬프트가 우선됩니다. webhook.urlstring- 서버의 HTTPS 주소입니다. 태스크가 끝나는 즉시 결과를 이 주소로 보냅니다.
응답
완료된 태스크는 이런 형태입니다. 길이를 줄여 보여 드립니다.
{
"success": true,
"task": {
"id": "ba954bab-33ec-4bb0-b175-a9b85258a4ac",
"taskType": "PROMPT_RESEARCH",
"status": "COMPLETED",
"createdAt": "2026-10-02T15:55:29.285Z"
},
"credits": { "creditsToCharge": 12, "creditsCharged": 12 },
"response": {
"seed": "wireless earbuds",
"country": "US",
"language": "en",
"seedMonthlySearchVolume": 165000,
"promptsFound": 28,
"prompts": [
{
"prompt": "Which noise-cancelling earbuds should I choose?",
"topic": "Earbud features",
"persona": null,
"intent": "commercial",
"funnelStage": "consideration",
"brandMentions": "likely",
"monthlySearchVolume": 118380,
"demandShare": 0.2585
},
{
"prompt": "What are the best wireless earbuds to buy?",
"topic": "Choosing earbuds",
"persona": null,
"intent": "commercial",
"funnelStage": "consideration",
"brandMentions": "likely",
"monthlySearchVolume": 78840,
"demandShare": 0.1722
}
],
"monitorSet": {
"prompts": [
{
"rank": 1,
"prompt": "Which noise-cancelling earbuds should I choose?",
"topic": "Earbud features",
"persona": null,
"intent": "commercial",
"funnelStage": "consideration",
"brandMentions": "likely",
"monthlySearchVolume": 118380,
"demandShare": 0.2585
}
],
"coverage": {
"demandShare": 0.8406,
"topics": { "total": 5, "covered": 5 },
"personas": { "total": 9, "covered": 8 }
}
},
"topics": [
{
"topic": "Choosing earbuds",
"monthlySearchVolume": 191440,
"promptCount": 9,
"demandShare": 0.4181
},
{
"topic": "Earbud features",
"monthlySearchVolume": 161940,
"promptCount": 6,
"demandShare": 0.3537
}
],
"personas": [
{
"persona": "people who sleep with earbuds",
"monthlySearchVolume": 17700,
"promptCount": 1,
"demandShare": 0.0387
}
],
"brands": [
{ "brand": "Beats", "monthlySearchVolume": 560980 },
{ "brand": "Apple", "monthlySearchVolume": 509920 },
{ "brand": "Samsung", "monthlySearchVolume": 91750 }
]
}
}task.statusstringQUEUED,PROCESSING을 거쳐 답변과 함께COMPLETED로, 또는error와 함께FAILED로 끝납니다.credits.creditsChargedinteger- 끝난 태스크에 청구된 크레딧입니다. 실패한 태스크는 0입니다.
response.promptsarray- 사람들이 AI 어시스턴트에게 묻는 질문을 수요가 큰 순서로 담습니다.
topic,persona,intent,funnelStage,monthlySearchVolume,demandShare가 함께 옵니다. response.monitorSetobject- 모니터가 추적할 프롬프트를 추가할 순서대로 담고, 수요, 토픽, 페르소나
coverage를 함께 줍니다. response.topicsarray- 하위 주제별로 합산한 수요입니다.
monthlySearchVolume,demandShare,promptCount가 담기고,personas는 같은 방식으로 대상별 수요를 담습니다. response.brandsarray- 이 분야에서 사람들이 검색하는 브랜드와 월간 검색량입니다.
결과 받기
요청하면 status가 QUEUED인 태스크가 바로 돌아옵니다. status가 COMPLETED나 FAILED가 될 때까지 GET /v1/async/task/{id}로 조회하거나, webhook.url을 넣어 같은 task, credits, response를 서버로 받으세요. 결과는 태스크가 끝난 뒤 24시간 동안 조회됩니다.
curl https://api.querying.ai/v1/async/task/$TASK_ID \
-H "Authorization: Bearer $QUERYING_API_KEY"요금
완료된 리서치 태스크마다 12크레딧이 차감됩니다.
다른 업데이트
정확한 위치 지정이 Google AI Mode, AI Overview, 검색 결과로 넓어졌어요
GOOGLE, AIMODE, GOOGLE_SERP 태스크에 payload.location을 넣어 그 장소의 사용자가 보는 AI Overview, AI Mode 답변, 검색 결과를 받으세요.
새 소식을 받아보세요
제품 업데이트를 이메일로 보내드립니다.