---
title: "Search Google"
method: GET
path: "/search"
tags: ["Google Search"]
---

# Search Google

`GET /search`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/search`
- Auth: API key in header `X-API-KEY`

Perform a Google search and get structured results including organic results,
related searches, knowledge graphs, and more.

Identical searches repeated within one hour are served from cache for free and
carry `cached: true`; add `no_cache=true` to force a fresh search.

## Query parameters

- `query` string, required
- `location` string, nullable
- `uule` string, nullable
- `google_domain` string, nullable
- `gl` string, nullable
- `cr` string, nullable
- `hl` string, nullable
- `lr` string, nullable
- `ludocid` string, nullable
- `lsig` string, nullable
- `kgmid` string, nullable
- `si` string, nullable
- `ibp` string, nullable
- `uds` string, nullable
- `oq` string, nullable
- `sclient` string, nullable
- `gs_lp` string, nullable
- `tbs` string, nullable
- `as_qdr` string, nullable
- `safe` 'active' | 'off' | 'null', nullable
- `nfpr` integer, nullable
- `filter` integer, nullable
- `tbm` 'isch' | 'vid' | 'nws' | 'lcl' | 'shop' | 'pts' | 'null', nullable
- `udm` integer, nullable
- `start` integer, nullable
- `include_thumbnails` '0' | '1' | 'true' | 'false' | 'null', nullable
- `page` integer, nullable
- `amount` integer, nullable
- `device` 'desktop' | 'tablet' | 'mobile' | 'null', nullable
- `proxy_country` 'pl' | 'null', nullable

## Response `200`

- object
  - `search_information` object, required
    - `query_displayed` string, required
    - `total_results` integer
    - `time_taken_displayed` number
  - `organic_results` object[], required
    - `position` integer, required
    - `title` string, required
    - `link` string, required
    - `redirect_link` string
    - `displayed_link` string
    - `snippet` string
    - `snippet_highlighted_words` string[]
    - `thumbnail` string
    - `favicon` string
    - `source` string
    - `followers` string
    - `followers_count` integer
    - `views` string
    - `view_count` integer
    - `date` string
    - `publication_age` string
    - `sitelinks` object
      - `inline` object[], required
        - `title` string, required
        - `link` string, required
    - `rich_snippet` string[]
  - `shops` object[]
    - `position` integer, required
    - `name` string, required
    - `link` string, required
    - `title` string
    - `snippet` string
  - `price_comparison_sites` object[]
    - `position` integer, required
    - `name` string, required
    - `domain` string
    - `link` string
  - `related_searches` object[], required
    - `query` string, required
    - `link` string, required
  - `people_also_search_for` object[], required
    - `name` string, required
    - `query` string, required
    - `link` string, required
    - `thumbnail` object
  - `related_questions` object[], required
    - `question` string, required
    - `text_blocks` object[]
  - `things_to_know` object[], required
    - `category` string, required
    - `question` string, required
  - `knowledge_graph` object, nullable, required
  - `see_results_about` object, nullable, required
    - `title` string, nullable, required
    - `description` string, nullable, required
    - `link` string, required
    - `search_term` string, nullable, required
  - `twitter_card` object, nullable, required
  - `inline_videos` object[], required
  - `inline_images` object[], required
  - `local_map` object, nullable, required
  - `local_results` object, nullable, required
    - `places` object[], required
  - `popular_products` object[], nullable, required
  - `perspectives` object[], nullable, required
  - `nutrition_information` object, nullable, required
  - `refine_this_search` object[], nullable, required
  - `organic_results_count` integer, required
  - `total_results` integer, nullable, required
  - `engine_used` string, required
  - `service_used` string, required
  - `cached` boolean

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `403`: The country parameter is not enabled for this account. Contact support to enable it.
- `422`: One or more query parameters failed validation.
- `429`: No Google Search worker is currently available. Retry after the number of seconds in the Retry-After response header.
- `503`: Google Search and fallback providers are temporarily unavailable.

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/1e1aa78ff103?raw)