SerpBase

Google Images Search — API 레퍼런스

POST
사용 가능
/google/image/search

이미지 검색

Google 이미지와 출처 링크를 검색합니다. 링크는 이미지 사용 권리를 부여하지 않습니다.

type
images
result
images
과금
1 credits

Google 이미지와 출처 링크를 검색합니다. 링크는 이미지 사용 권리를 부여하지 않습니다.

파라미터
q
필수
string

필수

검색 쿼리 문자열입니다.

hl
선택
string

선택

언어 코드입니다. 기본값은 en입니다.

gl
선택
string

선택

국가 코드입니다. 기본값은 us입니다.

page
선택
number

선택

1부터 시작하는 페이지 번호입니다. 기본값은 1입니다.

query
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "red pandas"

json
{
  "query": "red pandas"
}
Playground에서 실행
응답 필드
query
필수
string

필수

요청에서 정규화된 쿼리입니다.

page
필수
number

필수

현재 페이지 번호입니다. 1부터 시작합니다.

images
선택
ImageResult[]

이미지 결과가 파싱된 경우.

Google 이미지 검색 결과.

ImageResult 결과 항목 구조
rank
필수
number

필수

이 응답 안에서 1부터 시작하는 순위입니다.

position
선택
number

제공되는 경우 rank의 별칭입니다.

position 필드를 기대하는 클라이언트용 정규화 순위입니다.

title
선택
string

이미지 제목 또는 alt 텍스트를 파싱할 수 있을 때 반환됩니다.

결과 제목입니다.

link
필수
string

필수

파서가 반환하는 기본 링크입니다.

url
선택
string

결과 링크를 정규화할 수 있을 때 반환됩니다.

정규화된 대상 URL이며 보통 link와 같습니다.

source_url
선택
string

Google 리다이렉트/원본 URL이 관측된 경우에만 반환됩니다.

디버깅과 출처 확인을 위해 보존되는 원본 Google URL입니다.

display_url
선택
string

Google 표시 텍스트나 도메인을 추출할 수 있을 때 반환됩니다.

표시 URL 또는 출처 도메인입니다.

image_url
필수
string

필수

전체 이미지 URL.

thumbnail_url
선택
string

Google이 썸네일을 제공할 때 반환됩니다.

썸네일 URL입니다.

thumbnail
선택
string

제공되는 경우 thumbnail_url의 별칭입니다.

정규화된 썸네일 별칭입니다.

source
선택
string

출처 텍스트가 파싱된 경우.

이미지 출처 라벨.

domain
선택
string

원본 페이지 도메인을 도출할 수 있는 경우.

원본 페이지 도메인.

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/google/image/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"red pandas"}'
기존 Google 요청 예시
bash
curl -X POST https://api.serpbase.dev/google/image/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "iphone 15 pro blue",
    "hl": "en",
    "gl": "us",
    "page": 1
  }'
참고

비주얼 검색, 상품 모니터링, 이미지 출처 탐색.

일부 Google 이미지 형식은 rank/link만 제공하고 모든 정규화 별칭은 제공하지 않습니다. url, display_url, source_url, position, thumbnail은 선택 필드입니다.