seo/
search-intent

제출한 키워드를 최대 1,000개까지 검색 의도별로 분류하고, 주 의도와 보조 의도 라벨 및 확률을 정규화된 키워드 레코드로 반환합니다.

Search Intent API

키워드 일괄 입력
네 가지 의도 라벨
주 의도와 보조 의도
키워드당 0.1 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

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 사용 방법

키워드 목록을 선택적인 시장, 언어, 결과 수 제한 설정과 함께 제출하고, 완료된 비동기 작업에서 정규화된 의도 레코드를 읽습니다.

  1. 비어 있지 않고 각각 80자를 넘지 않는 키워드를 1~1,000개 준비합니다.
  2. keywords와 선택 사항인 시장, 언어, results_limit 필드를 /v1/seo/search-intent로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 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 true

Search Intent API 추천 활용 사례

  • 키워드 목록 라벨링: 키워드별 주 의도를 활용해, 준비해 둔 키워드 목록에 일관된 의도 라벨을 붙입니다.
  • 복합 의도 검토: 주 의도와 보조 의도 라벨을 확률과 함께 비교해, 검색 목적이 둘 이상일 수 있는 키워드를 찾아냅니다.
  • 리서치 워크플로 분배: 제출한 키워드를 informational, navigational, commercial, transactional 의도별로 묶은 뒤 각각의 리서치 워크플로로 보냅니다.

Search Intent API 활용 팁

  • 분류하려는 키워드 수에 맞게 입력 건수 기준 요금이 청구되도록, 일괄 요청을 제출하기 전에 빈 항목과 중복 항목을 제거하세요.
  • 일괄 요청 간에 결과를 비교할 때는 시장과 언어 필드를 같게 유지하세요.
  • 의도가 섞인 키워드는 주 의도 라벨을 보편적인 사실로 받아들이지 말고 보조 의도의 확률도 함께 확인하세요.
  • 분류 결과가 없을 수 있다고 가정하고, 원본 keyword_intent와 secondary_keyword_intents 객체를 검증할 때는 extra 필드를 읽으세요.

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 — 시드 검색어 하나에서 연관 검색 경로를 따라가며, 깊이 설정, 확인 가능한 키워드 측정값, 검색 의도 맥락, 전체 원본 행을 포함합니다.

다른 플랫폼 둘러보기

SEO 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Search Intent API — 자주 묻는 질문

Search Intent API는 제출한 키워드를 최대 1,000개까지 선택한 언어로 분류하는 프로그래밍 인터페이스입니다. 분류된 키워드마다 정규화된 주 의도와 보조 의도 라벨을 확률과 함께 반환합니다.

라벨은 informational, navigational, commercial, transactional 네 가지입니다.

keywords를 제출하고, 필요하면 location_code 또는 location_name을 지정하며, language_code 또는 language를 선택하고, 1~2,000 범위의 results_limit을 사용합니다.

비어 있지 않은 키워드를 1~1,000개 제출할 수 있으며, 키워드 하나의 최대 길이는 80자입니다.

의도 분류에 대한 신뢰도이며, 구매 확률이나 전환율이 아닙니다. 그래서 의도가 섞인 키워드에는 의미 있는 보조 분류가 포함될 수 있습니다.

아니요. 일부 키워드는 분류 결과가 나오지 않을 수 있으므로, 반환된 레코드는 keyword 기준으로 대조하고 없는 행을 처리하세요.

제출한 키워드 1개당 0.1 SocQ 크레딧이 차감됩니다.