Search Intent
검색 의도는 검색어를 informational, navigational, commercial, transactional 라벨로 설명하며, 주 의도와 보조 의도의 확률 신호를 함께 제공합니다. 이러한 분류는 키워드 목록 라벨링, 복합 의도 검토, 콘텐츠 브리프 정렬, 준비된 키워드 목록의 리서치 워크플로 분배에 활용할 수 있습니다.
Search Intent API 주요 기능
- 언어를 고려한 일괄 분류제출한 키워드를 최대 1,000개까지 선택한 언어 하나로 분류하며, 언어를 지정하지 않으면 영어를 사용합니다.
- 주 의도와 보조 의도 신호가장 가능성이 높은 의도와 그 확률을, 다른 유력한 의도와 해당 확률과 함께 반환합니다.
- 정규화된 레코드와 전체 레코드정규화된 keyword와 search_intent 필드를 읽을 수 있으며, keyword_intent와 secondary_keyword_intents는 extra 필드에 그대로 보존합니다.
Search Intent API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
keywords | 필수 | 비어 있지 않고 각각 80자를 넘지 않는 키워드 1~1,000개의 목록으로, 필수 값입니다. |
location_code | 선택 | 검색 시장의 지역을 나타내는 양수 코드로, 선택 값입니다. |
location_name | 선택 | location_code 대신 쓸 수 있는 검색 시장 이름으로, 선택 값입니다. 입력하면 location_code보다 우선합니다. |
language_code | 선택 | 2~10자의 검색 언어 코드로, 선택 값입니다. 플레이그라운드의 기본값은 en입니다. |
language | 선택 | language_code 대신 쓸 수 있는 검색 언어 이름으로, 선택 값입니다. 입력하면 language_code보다 우선합니다. |
results_limit | 선택 | 1~2,000 범위의 결과 수 상한으로, 선택 값입니다. |
Search Intent API 사용 방법
키워드 목록을 선택적인 시장, 언어, 결과 수 제한 설정과 함께 제출하고, 완료된 비동기 작업에서 정규화된 의도 레코드를 읽습니다.
- 비어 있지 않고 각각 80자를 넘지 않는 키워드를 1~1,000개 준비합니다.
- keywords와 선택 사항인 시장, 언어, results_limit 필드를 /v1/seo/search-intent로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽고, has_more가 true인 동안 next_cursor를 따라 다음 결과를 가져옵니다.
curl -X POST "https://api.socq.ai/v1/seo/search-intent" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keywords":["how to research keywords","buy seo software"],"language_code":"en"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueSearch Intent API 추천 활용 사례
- 키워드 목록 라벨링: 키워드별 주 의도를 활용해, 준비해 둔 키워드 목록에 일관된 의도 라벨을 붙입니다.
- 복합 의도 검토: 주 의도와 보조 의도 라벨을 확률과 함께 비교해, 검색 목적이 둘 이상일 수 있는 키워드를 찾아냅니다.
- 리서치 워크플로 분배: 제출한 키워드를 informational, navigational, commercial, transactional 의도별로 묶은 뒤 각각의 리서치 워크플로로 보냅니다.
Search Intent API 활용 팁
- 분류하려는 키워드 수에 맞게 입력 건수 기준 요금이 청구되도록, 일괄 요청을 제출하기 전에 빈 항목과 중복 항목을 제거하세요.
- 일괄 요청 간에 결과를 비교할 때는 시장과 언어 필드를 같게 유지하세요.
- 의도가 섞인 키워드는 주 의도 라벨을 보편적인 사실로 받아들이지 말고 보조 의도의 확률도 함께 확인하세요.
- 분류 결과가 없을 수 있다고 가정하고, 원본 keyword_intent와 secondary_keyword_intents 객체를 검증할 때는 extra 필드를 읽으세요.
관련 API
Search Intent API 외에 SEO의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Google Organic SERP API — 검색어와 시장으로 실시간 Google 검색 결과 페이지 하나를 가져오며, 정규화된 도착 URL, 순위, 요소 유형, 전체 결과 상세를 포함합니다.
- Keyword Difficulty API — 제출한 키워드 묶음의 오가닉 순위 난이도를 비교하며, 확인 가능한 각 키워드를 정규화된 점수와 함께 반환합니다.
- Keyword Overview API — 제출한 키워드 묶음에 확인 가능한 수요, 유료 경쟁, 난이도, 월간 검색량, 검색 의도 맥락을 더해 보강합니다.
- Keyword Search Volume API — 알고 있는 키워드의 검색량, CPC, 유료 경쟁, 월별 검색 추이를 측정합니다.
- Keyword Suggestions API — 시드 검색어 하나를 일치하는 롱테일 키워드로 확장하며, 확인 가능한 수요 측정값, 월별 추이, 검색 의도 맥락, 전체 원본 행을 포함합니다.
- Related Keywords API — 시드 검색어 하나에서 연관 검색 경로를 따라가며, 깊이 설정, 확인 가능한 키워드 측정값, 검색 의도 맥락, 전체 원본 행을 포함합니다.
- Keywords for Site API
- Ranked Keywords API
- Relevant Pages API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API