Google Organic SERP
Google 자연 검색 결과 페이지는 순위가 매겨진 링크와 함께 추천 스니펫, 질문, 지역 결과, 동영상 같은 다른 노출 요소로 구성됩니다. 이동 대상, 위치, 요소 유형, 표시 방식에 관한 정보는 순위 스냅샷, 레이아웃 분석, 기기·시장별 비교에 활용할 수 있습니다.
Google Organic SERP API 주요 기능
- 검색어 하나의 시장별 스냅샷시장, 언어, 데스크톱 또는 모바일 설정을 명시해 검색어 하나를 조회하므로 비교 가능한 특정 시점의 결과 페이지를 얻을 수 있습니다.
- 순위와 이동 URL 필드확인 가능한 이동 URL, 표시 제목, 그룹 내 위치, 절대 위치, 검색 결과 페이지 번호를 정규화된 필드로 반환합니다.
- 다양한 SERP 요소 지원자연 검색 링크와 그 밖에 반환된 결과 유형을 그대로 보존하며, 각 레코드가 어떤 요소인지는 extra.type으로 구분합니다.
- 요소 전체 정보 유지요소별 객체 전체를 extra에 보관하므로 도메인, 스니펫, 이동 경로, 이미지, 리치 결과 속성이 있는 경우 그대로 사용할 수 있습니다.
Google Organic SERP API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
query | 필수 | 비어 있지 않아야 하는 필수 검색어입니다. 작업 하나에는 검색어 하나만 사용할 수 있습니다. |
location_code | 선택 | 양의 정수인 시장 코드입니다. 플레이그라운드의 기본값은 미국을 뜻하는 2840입니다. |
location_name | 선택 | location_code 대신 쓸 수 있는 검색 시장 이름으로, 선택 값입니다. 입력하면 location_code보다 우선합니다. |
language_code | 선택 | 길이 2~10자의 검색 언어 코드입니다. 플레이그라운드의 기본값은 en입니다. |
language | 선택 | language_code 대신 쓸 수 있는 검색 언어 이름으로, 선택 값입니다. 입력하면 language_code보다 우선합니다. |
device | 선택 | 검색 기기 환경으로, desktop 또는 mobile입니다. |
results_limit | 선택 | 요청할 순위 조회 깊이로 1에서 700 사이의 값입니다. 상한선일 뿐이며 평탄화된 요소가 같은 개수로 반환된다는 것을 보장하지는 않습니다. |
Google Organic SERP API 사용 방법
코드 기반 시장 설정과 정해진 조회 깊이로 검색어 하나를 제출하고, 완료된 비동기 작업에서 정규화된 SERP 요소를 하나씩 읽습니다.
- 비어 있지 않은 query 하나, location_code, language_code, device, 그리고 1에서 200 사이의 results_limit을 정합니다.
- 페이로드를 /v1/seo/google-organic-serp로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패를 반환할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽고, has_more가 true인 동안 반환된 next_cursor로 다음 결과를 요청합니다.
curl -X POST "https://api.socq.ai/v1/seo/google-organic-serp" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"keyword research","location_code":2840,"language_code":"en","device":"desktop","results_limit":10}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueGoogle Organic SERP API 추천 활용 사례
- 현재 순위 스냅샷: 이동 URL을 rank.group, rank.absolute, rank.page, collected_at과 함께 사용해, 정해 둔 검색어에서 반환된 페이지가 어디에 노출되는지 기록합니다.
- 기기·시장별 비교: device, location_code, language_code 값을 통제한 상태로 같은 조건의 검색어를 제출해, 환경별 결과 이동 대상과 순위를 비교합니다.
- SERP 레이아웃 분석: extra.type과 요소별 필드를 살펴 순위가 매겨진 링크를 질문, 스니펫, 지역 결과, 동영상 등 페이지에 반환된 다른 기능과 구분합니다.
Google Organic SERP API 활용 팁
- 데스크톱과 모바일을 비교할 때는 기기만 의도한 변수가 되도록 query, location_code, language_code를 바꾸지 마세요.
- 경로 검증은 더 큰 값도 허용하지만 실시간 고급 결과의 조회 깊이는 200으로 제한되므로, results_limit은 200 이하로 사용하세요.
- 요소별 키를 읽기 전에 extra.type으로 분기하고, 값을 제공하지 않는 요소에서는 url과 rank 값이 없을 수 있다고 가정하세요.
- rank.page는 검색 결과 페이지 번호로 취급하고, 저장된 SocQ 결과 레코드의 페이지네이션에는 next_cursor를 별도로 사용하세요.
- extra의 사용 가능한 키는 SERP 요소 유형에 따라 다르고 바뀔 수도 있으므로, 유연한 객체로 저장하세요.
관련 API
Google Organic SERP API 외에 SEO의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Keyword Difficulty API — 제출한 키워드 묶음의 오가닉 순위 난이도를 비교하며, 확인 가능한 각 키워드를 정규화된 점수와 함께 반환합니다.
- Keyword Overview API — 제출한 키워드 묶음에 확인 가능한 수요, 유료 경쟁, 난이도, 월간 검색량, 검색 의도 맥락을 더해 보강합니다.
- Keyword Search Volume API — 알고 있는 키워드의 검색량, CPC, 유료 경쟁, 월별 검색 추이를 측정합니다.
- Related Keywords API — 시드 검색어 하나에서 연관 검색 경로를 따라가며, 깊이 설정, 확인 가능한 키워드 측정값, 검색 의도 맥락, 전체 원본 행을 포함합니다.
- Search Intent API — 제출한 키워드 묶음의 주요 및 보조 검색 의도를 분류하며, 원본 확률값과 전체 레코드를 유지합니다.
- Google News API — 검색어에 대한 Google 뉴스 기사를 주요 뉴스부터 제목, 언론사, 기사 직링크, 요약, 발행 시각과 함께 수집합니다.
- Keywords for Site API
- Keyword Suggestions 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 Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API