---
title: "Google Search (Light)"
method: GET
path: "/search-light"
tags: ["Google Search"]
---

# Google Search (Light)

`GET /search-light`

## Request

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

Perform a lightweight Google search. Returns structured JSON results.

Limitations:
- Max 200 results per query (10 pages × 20 results)

Tip: Use query modifiers like `filetype:pdf`, `site:reddit.com`, or `"exact phrase"` in your query.
     *
     * Response includes total_results at the root level as a convenience accessor
     * that mirrors search_information.total_results. people_also_search_for is
     * best-effort autocomplete enrichment and may be empty.
     *
     * @queryParam query string required The search query. Use modifiers like filetype:pdf, site:reddit.com, or "exact phrase". Example: artificial intelligence
     * @queryParam num integer Number of results per page (1-20). Default: 10. Example: 10
     * @queryParam page integer Page number for pagination (1-10). Mutually exclusive with "start". Example: 1
     * @queryParam start integer Starting index for offset-based pagination (0-170). Mutually exclusive with "page". Example: 0

## Query parameters

- `query` string, required
- `num` integer, nullable
- `start` integer, nullable
- `page` integer, nullable
- `hl` string, nullable
- `lr` string, nullable
- `gl` string, nullable
- `cr` string, nullable
- `safe` 'active' | 'off' | 'null', nullable
- `dateRestrict` string, nullable
- `sort` 'date' | 'date:r' | 'date:d' | 'null', nullable
- `filter` integer, nullable
- `rights` 'cc_publicdomain' | 'cc_attribute' | 'cc_sharealike' | 'cc_noncommercial' | 'cc_nonderived' | 'null', nullable

## Response `200`

- object
  - `organic_results` object[], required
    - `position` integer, required
    - `title` string, required
    - `link` string, required
    - `displayed_link` string, required
    - `snippet` string, nullable, required
    - `snippet_highlighted_words` string[], required
    - `thumbnail` string, nullable, required
    - `rich_snippet` unknown[], nullable, required
      - unknown
    - `views` string
    - `view_count` integer
    - `date` string
    - `publication_age` string
  - `people_also_search_for` string[], required
  - `search_information` object, required
    - `query_displayed` string, required
    - `total_results` integer, required
    - `time_taken` number, required
  - `pagination` object, required
    - `current_page` integer, required
    - `pages` unknown[], required
      - unknown
  - `total_results` integer, required

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `403`: The API key is valid, but the account cannot use Search Light because email verification, free request, subscription, or credit-pack access is blocked.
- `422`: The query, pagination, localization, safe search, date, sort, duplicate filter, or rights parameters failed validation.
- `500`: Search Light fetched a response but could not parse it into the documented JSON result structure.
- `503`: The upstream service is temporarily unavailable. Please retry shortly.

---

[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/2f4af6143d10?raw)