SerpBase

API 레퍼런스 · 검색 엔진

Google 링크 변환

무료: Google 결과의 google.com/goto, /url 래핑 링크를 실제 페이지 URL로 변환합니다. 요청당 최대 50개, 링크 목록이나 검색 결과 그대로 보낼 수 있습니다.

POSThttps://api.serpbase.dev/google/resolve
0 크레딧Playground에서 실행

예시

BASH
curl -X POST 'https://api.serpbase.dev/google/resolve' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  --max-time 60 \
  -d '{"links":["https://www.google.com/url?sa=t&url=https%3A%2F%2Fwww.example.com%2F"]}'

이 엔드포인트의 실제 응답 예시는 아직 없습니다. Playground에서 예시를 실행해 실제 응답을 확인하세요.

매개변수

links
string[]
Google 결과 링크(https://www.google.com/goto?...
더 보기

또는 /url?...) 최대 50개. 그 외 URL은 거부되며 중복은 한 번만 처리합니다.

response
object
links 대신 받은 검색 결과를 그대로 보낼 수 있습니다.
더 보기

포함된 Google 링크를 순서대로 모두 변환합니다. links와 response 중 하나만 보내세요.

country
string
locale.country: 별칭은 한 번에 하나의 표기만 사용하세요.
더 보기

API는 지원 매개변수와 값을 검증합니다.

cursor
string
pagination.cursor: 별칭은 한 번에 하나의 표기만 사용하세요.
더 보기

API는 지원 매개변수와 값을 검증합니다.

device
string
options.device: 별칭은 한 번에 하나의 표기만 사용하세요.
더 보기

API는 지원 매개변수와 값을 검증합니다.

gl
string
locale.country: 별칭은 한 번에 하나의 표기만 사용하세요.
더 보기

API는 지원 매개변수와 값을 검증합니다.

google_domain
string
locale.engine_domain: 별칭은 한 번에 하나의 표기만 사용하세요.
더 보기

API는 지원 매개변수와 값을 검증합니다.

gooogle_domain
string
locale.engine_domain: 별칭은 한 번에 하나의 표기만 사용하세요.
더 보기

API는 지원 매개변수와 값을 검증합니다.

hl
string
locale.language: 별칭은 한 번에 하나의 표기만 사용하세요.
더 보기

API는 지원 매개변수와 값을 검증합니다.

html
boolean
include_html: 별칭은 한 번에 하나의 표기만 사용하세요.
더 보기

API는 지원 매개변수와 값을 검증합니다.

language
string
locale.language: 별칭은 한 번에 하나의 표기만 사용하세요.
더 보기

API는 지원 매개변수와 값을 검증합니다.

limit
integer
pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요.
더 보기

API는 지원 매개변수와 값을 검증합니다.

markdown
boolean
include_markdown: 별칭은 한 번에 하나의 표기만 사용하세요.
더 보기

API는 지원 매개변수와 값을 검증합니다.

mobile
boolean
options.device: 별칭은 한 번에 하나의 표기만 사용하세요.
더 보기

API는 지원 매개변수와 값을 검증합니다.

num
integer
pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요.
더 보기

API는 지원 매개변수와 값을 검증합니다.

page
integer
pagination.page: 별칭은 한 번에 하나의 표기만 사용하세요.
더 보기

API는 지원 매개변수와 값을 검증합니다.

q
string
query: 별칭은 한 번에 하나의 표기만 사용하세요.
더 보기

API는 지원 매개변수와 값을 검증합니다.

results
integer
pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요.
더 보기

API는 지원 매개변수와 값을 검증합니다.

무료(0 크레딧). 한도: 요청당 링크 50개, 계정당 분당 30회. Google이 이 링크들을 속도 제한하므로 한 번에 최대 약 25초 걸릴 수 있습니다. 끝내지 못한 링크는 reason이 paced_over_budget로 반환됩니다. 약 2분 뒤에 다시 보내세요. 더 일찍 보내면 Google의 대기 시간이 길어집니다.

반환 필드

해당 요청 페이지에 없는 내용의 필드는 빈 값 대신 생략됩니다.

resolved_links
필수
ResolvedLink[]

필수

링크마다 한 항목, 요청 순서대로 반환됩니다.

ResolvedLink 결과 항목 구조

link
필수
string

필수

보낸 Google 링크.

url
선택
string

변환된 경우.

링크가 가리키는 페이지. 이번에 변환하지 못하면 포함되지 않습니다.

reason
필수
string

필수

resolved 또는 실패 이유: paced_over_budget(Google이 요구한 대기 시간이 한 번의 요청 한도를 넘음, 약 2분 뒤에 다시 보내고 그 전에는 보내지 마세요), challenge, no_location, timeout, not_a_wrapper, error.

실패할 때

실패한 요청은 status가 0이 아니고 error가 있으며 과금되지 않습니다. 자주 보이는 것:

1000매개변수 누락 또는 오류요청 수정
1020크레딧 부족충전
1029초당 요청 수 초과Retry-After초 대기
1502 · 1504이번에는 원본을 읽지 못함재시도
모든 상태 코드 →