seo/
google-images

Google 이미지가 검색어에 어떤 사진을 보여 주고 그 사진이 어디서 왔는지 확인합니다. 원본 파일, 썸네일, 제목, 대체 텍스트, 이미지가 실린 페이지와 사이트를 반환합니다.

Google Images API

원본 이미지 URL
출처 페이지와 사이트
대체 텍스트
최대 700개
결과당 0.03 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Google Images

Google 이미지는 검색마다 웹 전체의 이미지에 순위를 매기고, 이미지마다 제목, 출처 사이트, 이미지가 실린 페이지 링크를 보여 주며, 그 뒤에는 파일의 대체 텍스트가 있습니다. 이 순위를 읽으면 브랜드 제품 사진이 쇼핑 검색에 노출되는지, 카테고리의 이미지 결과를 어떤 사이트가 차지하는지, 이미지가 어디서 재사용되는지 알 수 있고, 주제별 시각 자료를 빠르게 모으는 방법도 됩니다.

Google Images API 주요 기능

  • 이미지 파일과 미리보기image_url은 원본 크기 파일을, thumbnail_url은 Google이 보여 주는 미리보기를 가리켜 원본을 내려받거나 가벼운 그리드로 보여 줄 수 있습니다.
  • 모든 이미지의 출처 페이지url은 이미지가 실린 페이지이고, source는 사이트 이름, domain은 그 도메인입니다.
  • 제목과 대체 텍스트title은 Google이 보여 주는 이미지 제목, text는 이미지의 대체 텍스트로, 이미지가 어떻게 설명되는지 확인할 수 있습니다.
  • 어떤 시장이든 순위대로rank는 Google 순서를 유지하며, 국가, 언어, 1~700의 results_limit으로 얼마나 깊이 읽을지 정합니다.

Google Images API 매개변수

매개변수필수설명
query필수이미지 검색어로, 제품, 스타일, 피사체 등을 넣습니다.
location_code선택검색 시장의 위치 코드입니다. 기본값은 2840(미국)입니다.
location_name선택location_code 대신 쓰는 시장 이름으로, 입력하면 location_code보다 우선합니다.
language_code선택검색 언어 코드입니다. 기본값은 en입니다.
language선택language_code 대신 쓰는 언어 이름으로, 입력하면 language_code보다 우선합니다.
results_limit선택가져올 이미지 수의 상한으로 1~700, 기본값은 100입니다.

Google Images API 사용 방법

검색어를 보내고 이미지마다 한 행으로 받습니다.

  1. {"query": "modern living room", "results_limit": 100}을 /v1/seo/google-images에 POST합니다.
  2. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. results.items에서 rank 순서대로 이미지를 읽고, has_more가 true인 동안 results.next_cursor로 다음 페이지를 요청합니다.
curl -X POST "https://api.socq.ai/v1/seo/google-images" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"modern living room","results_limit":100}'

Google Images API 추천 활용 사례

  • 제품 사진 순위 확인: 쇼핑 키워드를 조회해 결과에서 자사 도메인을 찾고, 제품 이미지가 몇 위인지와 그 위에 어떤 경쟁사가 있는지 확인합니다.
  • 이미지를 재사용하는 사이트 찾기: 제품명이나 브랜드명으로 검색해 결과마다 url과 domain을 살펴 자사 사진을 게시한 페이지를 찾아냅니다.
  • 시각 레퍼런스 수집: 스타일이나 주제별로 수백 개를 가져와 thumbnail_url을 그리드로 배치해 무드보드나 크리에이티브 브리프에 씁니다.
  • 카테고리 대체 텍스트 점검: 상위 이미지의 text를 자사 대체 텍스트와 비교해, 카테고리에서 잘 노출되는 이미지가 어떻게 설명되는지 살펴봅니다.

Google Images API 활용 팁

  • 상위 몇 줄 안에 드는지만 알고 싶다면 results_limit을 작게 잡으세요. 이미지 1개마다 0.03크레딧이 듭니다.
  • 페이지나 보고서에 결과를 보여 줄 때는 thumbnail_url을 불러오고 url로 링크하며, image_url은 원본 크기가 꼭 필요한 이미지에만 쓰세요.
  • 같은 키워드를 여러 나라에서 추적한다면 query는 그대로 두고 위치 항목만 바꿔야 순위를 깔끔하게 비교할 수 있습니다.

Google Images API 외에 SEO의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Google Organic SERP API — 검색어와 시장으로 실시간 Google 검색 결과 페이지 하나를 가져오며, 정규화된 도착 URL, 순위, 요소 유형, 전체 결과 상세를 포함합니다.
  • Keyword Difficulty API — 제출한 키워드 묶음의 오가닉 순위 난이도를 비교하며, 확인 가능한 각 키워드를 정규화된 점수와 함께 반환합니다.
  • Keyword Overview API — 제출한 키워드 묶음에 확인 가능한 수요, 유료 경쟁, 난이도, 월간 검색량, 검색 의도 맥락을 더해 보강합니다.
  • Keyword Search Volume API — 알고 있는 키워드의 검색량, CPC, 유료 경쟁, 월별 검색 추이를 측정합니다.
  • Keywords for Site API — 웹사이트 하나와 관련된 키워드를 생성하며, 확인 가능한 수요 측정값, 월별 추이, 시장 맥락, 전체 원본 행을 포함합니다.
  • Google Autocomplete API — 검색어 앞부분에 대해 Google이 제안하는 자동완성 검색어를 Google 순서 그대로, 원하는 국가와 언어로 수집합니다.

다른 플랫폼 둘러보기

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

Google Images API — 자주 묻는 질문

Google Images API는 선택한 국가와 언어에서 검색어에 대한 Google 이미지 결과를 반환하는 API로, 결과마다 원본 이미지 URL, 썸네일, 제목, 대체 텍스트, 순위, 이미지가 실린 페이지와 사이트가 들어 있습니다.

image_url은 이미지 파일 자체이고, url은 그 이미지가 실린 웹 페이지입니다.

results_limit은 1~700을 받으며 기본값은 100입니다.

반환된 이미지 1개마다 0.03크레딧입니다.