응답 형식

모든 Google 엔진은 동일한 최상위 구조를 반환합니다. organic_results 내부의 구체적인 필드와 SERP 기능 블록은 엔진에 따라 다르지만, 봉투 구조 자체는 동일합니다.

Top-level fields

Field	Type	Description
search_metadata	object	쿼리 에코, 타이밍, 요청 id
search_parameters	object	전송한 모든 파라미터
search_information	object	총 결과 수, 표시된 쿼리
organic_results	array	순위가 매겨진 웹 결과
pagination	object	다음/이전 페이지 커서
serpapi_pagination	object	표준 페이지네이션 헬퍼

SERP 기능은 페이지에 존재할 경우 추가 최상위 필드로 표시됩니다:

Field	Engine that returns it
ads	google
answer_box	google
knowledge_graph	google
related_questions	google
related_searches	google, bing, yandex
inline_images	google
inline_videos	google
local_results	google
local_map	google
shopping_results	google_shopping
news_results	google_news
jobs_results	google_jobs
events_results	google_events
places_results	google_maps
reviews_results	google_maps_reviews
interest_over_time	google_trends

search_metadata

{
  "id": "66f4a7b2e4b00b0001a1b2c3",
  "status": "Success",
  "created_at": "2026-02-01T12:34:56.789Z",
  "processed_at": "2026-02-01T12:34:58.012Z",
  "google_url": "https://www.google.com/search?q=pizza&...",
  "raw_html_file": "https://serp.shifter.io/raw_html/...",
  "total_time_taken": 2.31
}

organic_results

{
  "organic_results": [
    {
      "position": 1,
      "title": "Best Pizza in Chicago",
      "link": "https://example.com/pizza",
      "displayed_link": "example.com",
      "snippet": "Chicago's deep dish institution since 1955...",
      "favicon": "https://example.com/favicon.ico",
      "sitelinks": { "...": "..." }
    }
  ]
}

pagination

{
  "pagination": {
    "current": 1,
    "next": "https://serp.shifter.io/v1?engine=google&q=pizza&start=10&...",
    "other_pages": { "2": "...start=10...", "3": "...start=20..." }
  }
}

다음 페이지에는 start를 전달하거나(10, 20, …) next URL을 직접 따라가면 됩니다.

Error responses

실패 시, 최상위에는 error와 error_code만 포함됩니다:

{
  "error": "Your API key is invalid",
  "error_code": 401
}

See also

• Google SERP 개요