> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Light Search

> Organic results and related searches through a dedicated lightweight endpoint.

A successful request costs **10 credits**. Failed requests are free. Check
`X-Credits-Used` for the actual charge and `/api/public/pricing` for current
prices and promotions.

```bash theme={null}
curl --get 'https://scrapebadger.com/v1/google/light/search' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data-urlencode 'q=vinted api' \
  --data-urlencode 'gl=us' \
  --data-urlencode 'hl=en'
```

The JSON response contains `search_information`, `organic_results`,
`related_searches` and `pagination`. Light skips ads, AI Overviews, Knowledge
Graph, People Also Ask, local results, news, inline videos and shopping.
No `mode` parameter is required. Passing `mode=full` or `ai_overview=true`
cannot enable rich SERP features.

Use `start=10`, `20`, and so on for later pages. Google may return fewer results
than requested by `num`; a page commonly contains about ten organic results.
Set `output=html` to receive the raw Google response instead of parsed JSON.

`search_information.organic_results_state` is `Results for exact spelling`, `Results for spelling correction` (Google showed results for a corrected spelling), `Results with suggested correction` (Google suggested a spelling with "Did you mean" but kept your query) or `no_results`. `total_results` and `time_taken` are filled only when Google prints them. Light usually gets Google's basic page, which shows no result count or search time, so both are often `null` on Light. Use [regular Search](https://docs.scrapebadger.com/api-reference/google/google-search/google-web-search.md) when you need them.

Light attempts to resolve every organic result URL within one short lookup
budget, without waiting for Google's verification timers. If Google delays a
link or changes its response, that link can remain a `google.com/goto` redirect.
Every result keeps its position. Treat a redirect as an unresolved destination
when tracking rankings; do not count `google.com` as the ranking website.

Light has a 12-second processing budget, including fetching, fallback and
parsing. If the budget expires, the response is `503` with `Retry-After`.

The CLI command is `scrapebadger google light-search "vinted api"`. The MCP tool
is `google_light_search`, with `start` for pagination.

See the [Light overview](https://docs.scrapebadger.com/google-light/overview.md) or
[regular Search](https://docs.scrapebadger.com/api-reference/google/google-search/google-web-search.md).

## Location and request controls

Light resolves `location` into Google UULE, like full Search. It also accepts
`uule`, paired `lat`/`lon`, `radius`, `color_scheme` and advanced `as_*` filters.
Every request is fetched fresh. Its response includes `search_parameters` and
`search_metadata` to distinguish requested targeting from observed fetch details.

See [location and request controls](https://docs.scrapebadger.com/api-reference/google/google-search/google-web-search.md#location-and-request-controls)
for validation rules and examples. Light remains a web-only API and cannot enable
other search types or rich result blocks.

## Google request fields

Search sends `oq=q`, `sourceid=chrome`, and `ie=UTF-8` by default. Override them with the same-named parameters. An explicit empty string omits that field from the Google request. These are Google query parameters; `sourceid` does not change the browser User-Agent, and `ie` is an encoding hint.

**oq** `string`

Original query sent to Google. Defaults to q; an empty string omits it.

**sourceid** `string` (default: chrome)

Google source identifier. Defaults to chrome; an empty string omits it.

**ie** `string` (default: UTF-8)

Google input encoding hint. Defaults to UTF-8; an empty string omits it.

The `udm=web` alias is accepted and sent to Google as `udm=14`. Inspect `search_parameters.google_parameters` to see the actual request. Matching these fields does not guarantee identical rankings across separate sessions.


## OpenAPI

````yaml GET /v1/google/light/search
openapi: 3.1.0
info:
  title: ScrapeBadger Google Scraper
  description: >-
    Dedicated API for scraping Google products (SERP, Maps, News, Hotels,
    Trends, Jobs, Shopping, Patents, Scholar, Autocomplete, Images, Videos,
    Finance, AI Mode, Lens, Products).
  version: 1.0.0
servers:
  - url: https://scrapebadger.com
    description: Production
security:
  - apiKeyAuth: []
paths:
  /v1/google/light/search:
    get:
      tags:
        - Google Light Search
      summary: Google Light web search
      description: |-
        Google Light Search: organic results and related searches, 10 credits.

        The dedicated route always uses the lightweight fetch path. It cannot be
        upgraded to full Search by passing mode=full or ai_overview=true.
      operationId: google_light_search_api_v1_light_search_get
      parameters:
        - name: q
          in: query
          required: true
          schema:
            type: string
            description: Search query (supports Google operators)
            title: Q
          description: Search query (supports Google operators)
        - name: gl
          in: query
          required: false
          schema:
            type: string
            description: Country code
            default: us
            title: Gl
          description: Country code
        - name: hl
          in: query
          required: false
          schema:
            type: string
            description: Language code
            default: en
            title: Hl
          description: Language code
        - name: num
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            default: 10
            title: Num
        - name: start
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            description: Page offset (0, 10, 20...)
            default: 0
            title: Start
          description: Page offset (0, 10, 20...)
        - name: domain
          in: query
          required: false
          schema:
            type: string
            description: Google domain
            default: google.com
            title: Domain
          description: Google domain
        - name: location
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: City-level geo-targeting
            title: Location
          description: City-level geo-targeting
        - name: uule
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Encoded location
            title: Uule
          description: Encoded location
        - name: lr
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Language restrict (e.g. lang_en)
            title: Lr
          description: Language restrict (e.g. lang_en)
        - name: tbs
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Time filter (e.g. qdr:d)
            title: Tbs
          description: Time filter (e.g. qdr:d)
        - name: safe
          in: query
          required: false
          schema:
            type: string
            description: 'Safe search: off or active'
            default: 'off'
            title: Safe
          description: 'Safe search: off or active'
        - name: filter
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                maximum: 1
                minimum: 0
              - type: 'null'
            title: Filter
        - name: nfpr
          in: query
          required: false
          schema:
            type: integer
            description: Disable auto-correction
            default: 0
            title: Nfpr
          description: Disable auto-correction
        - name: output
          in: query
          required: false
          schema:
            enum:
              - json
              - html
            type: string
            default: json
            title: Output
        - name: google_domain
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Alias for domain; Google requests use google.com with country
              targeting.
            title: Google Domain
          description: >-
            Alias for domain; Google requests use google.com with country
            targeting.
        - name: lat
          in: query
          required: false
          schema:
            anyOf:
              - type: number
                maximum: 90
                minimum: -90
              - type: 'null'
            description: Latitude; supply together with lon instead of location or uule.
            title: Lat
          description: Latitude; supply together with lon instead of location or uule.
        - name: lon
          in: query
          required: false
          schema:
            anyOf:
              - type: number
                maximum: 180
                minimum: -180
              - type: 'null'
            description: Longitude; supply together with lat.
            title: Lon
          description: Longitude; supply together with lat.
        - name: radius
          in: query
          required: false
          schema:
            anyOf:
              - type: number
                maximum: 1000
                minimum: 1
              - type: 'null'
            description: >-
              Location accuracy in meters; requires lat/lon or a named city with
              a known center.
            title: Radius
          description: >-
            Location accuracy in meters; requires lat/lon or a named city with a
            known center.
        - name: color_scheme
          in: query
          required: false
          schema:
            anyOf:
              - enum:
                  - light
                  - dark
                type: string
              - type: 'null'
            description: Google color scheme.
            title: Color Scheme
          description: Google color scheme.
        - name: tbm
          in: query
          required: false
          schema:
            anyOf:
              - enum:
                  - isch
                  - lcl
                  - vid
                  - nws
                  - shop
                  - pts
                  - bks
                type: string
              - type: 'null'
            description: >-
              Google search type. Use output=html for verticals; dedicated APIs
              provide parsed vertical results.
            title: Tbm
          description: >-
            Google search type. Use output=html for verticals; dedicated APIs
            provide parsed vertical results.
        - name: udm
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                pattern: ^[0-9]{1,3}$
              - type: 'null'
            description: >-
              Google result filter: web or 14 for web, 18 for forums. Other
              verticals require output=html.
            title: Udm
            pattern: ^(web|[0-9]{1,3})$
          description: >-
            Google result filter: web or 14 for web, 18 for forums. Other
            verticals require output=html.
        - name: no_cache
          in: query
          required: false
          schema:
            type: boolean
            description: >-
              Ignored: responses are never cached, so every request is fetched
              fresh. Accepted for compatibility.
            default: false
            title: No Cache
          description: >-
            Ignored: responses are never cached, so every request is fetched
            fresh. Accepted for compatibility.
        - name: as_dt
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                pattern: ^[ie]$
              - type: 'null'
            description: 'Site restriction mode: i includes, e excludes as_sitesearch.'
            title: As Dt
          description: 'Site restriction mode: i includes, e excludes as_sitesearch.'
        - name: as_epq
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Exact phrase.
            title: As Epq
          description: Exact phrase.
        - name: as_eq
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Words to exclude.
            title: As Eq
          description: Words to exclude.
        - name: as_lq
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Find pages linking to this URL; availability depends on Google.
            title: As Lq
          description: Find pages linking to this URL; availability depends on Google.
        - name: as_nlo
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Numeric range minimum.
            title: As Nlo
          description: Numeric range minimum.
        - name: as_nhi
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Numeric range maximum.
            title: As Nhi
          description: Numeric range maximum.
        - name: as_oq
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Match any of these words.
            title: As Oq
          description: Match any of these words.
        - name: as_q
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Additional query words.
            title: As Q
          description: Additional query words.
        - name: as_qdr
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Time range, such as d, w, m or y1.
            title: As Qdr
          description: Time range, such as d, w, m or y1.
        - name: as_rq
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Related URL; availability depends on Google.
            title: As Rq
          description: Related URL; availability depends on Google.
        - name: as_sitesearch
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Restrict results to a site.
            title: As Sitesearch
          description: Restrict results to a site.
        - name: device
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Device target.
            title: Device
          description: Device target.
        - name: user_agent
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Custom User-Agent.
            title: User Agent
          description: Custom User-Agent.
        - name: cr
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Country restrict.
            title: Cr
          description: Country restrict.
        - name: ludocid
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Place CID.
            title: Ludocid
          description: Place CID.
        - name: lsig
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Map view ID.
            title: Lsig
          description: Map view ID.
        - name: kgmid
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Knowledge Graph entity ID.
            title: Kgmid
          description: Knowledge Graph entity ID.
        - name: si
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Cached Google parameters.
            title: Si
          description: Cached Google parameters.
        - name: ibp
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Layout control.
            title: Ibp
          description: Layout control.
        - name: uds
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Google filter string.
            title: Uds
          description: Google filter string.
        - name: oq
          in: query
          required: false
          description: >-
            Original query sent to Google. Defaults to q; an empty string omits
            it.
          schema:
            anyOf:
              - type: string
              - type: 'null'
        - name: sourceid
          in: query
          required: false
          description: >-
            Google source identifier. Defaults to chrome; an empty string omits
            it.
          schema:
            anyOf:
              - type: string
              - type: 'null'
            default: chrome
        - name: ie
          in: query
          required: false
          description: >-
            Google input encoding hint. Defaults to UTF-8; an empty string omits
            it.
          schema:
            anyOf:
              - type: string
              - type: 'null'
            default: UTF-8
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleLightSearchResponse'
            text/html: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    GoogleLightSearchResponse:
      properties:
        search_information:
          $ref: '#/components/schemas/SearchInformation'
        organic_results:
          items:
            $ref: '#/components/schemas/OrganicResult'
          type: array
          title: Organic Results
        related_searches:
          items:
            $ref: '#/components/schemas/RelatedSearch'
          type: array
          title: Related Searches
        pagination:
          $ref: '#/components/schemas/Pagination'
      type: object
      required:
        - search_information
        - pagination
      title: GoogleLightSearchResponse
      description: Essential SERP data returned by GET /api/v1/light/search.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    SearchInformation:
      properties:
        query_displayed:
          type: string
          title: Query Displayed
        total_results:
          anyOf:
            - type: integer
            - type: 'null'
          title: Total Results
        time_taken:
          anyOf:
            - type: number
            - type: 'null'
          title: Time Taken
        organic_results_state:
          anyOf:
            - type: string
            - type: 'null'
          title: Organic Results State
        url:
          anyOf:
            - type: string
            - type: 'null'
          title: Url
      type: object
      required:
        - query_displayed
      title: SearchInformation
      description: Metadata about the search query.
    OrganicResult:
      properties:
        position:
          title: Position
          type: integer
        title:
          title: Title
          type: string
        link:
          type: string
          title: Link
        displayed_link:
          anyOf:
            - type: string
            - type: 'null'
          title: Displayed Link
        snippet:
          anyOf:
            - type: string
            - type: 'null'
          title: Snippet
        highlighted_keywords:
          items:
            type: string
          type: array
          title: Highlighted Keywords
        source:
          anyOf:
            - type: string
            - type: 'null'
          title: Source
        favicon:
          anyOf:
            - type: string
            - type: 'null'
          title: Favicon
        sitelinks:
          items:
            $ref: '#/components/schemas/Sitelink'
          title: Sitelinks
          type: array
        inline_sitelinks:
          items:
            $ref: '#/components/schemas/InlineSitelink'
          type: array
          title: Inline Sitelinks
        date:
          anyOf:
            - type: string
            - type: 'null'
          title: Date
        rich_snippet:
          anyOf:
            - $ref: '#/components/schemas/RichSnippet'
            - type: 'null'
          default: null
        read_more_link:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: >-
            The snippet's "Read more" link: the page, usually with a `#:~:text=`
            fragment that scrolls to the quoted passage.
          title: Read More Link
        rank:
          anyOf:
            - type: integer
            - type: 'null'
          title: Rank
        page_rank:
          anyOf:
            - type: integer
            - type: 'null'
          title: Page Rank
      type: object
      required:
        - position
        - title
        - link
      title: OrganicResult
      description: A single organic search result.
    RelatedSearch:
      properties:
        query:
          type: string
          title: Query
        link:
          anyOf:
            - type: string
            - type: 'null'
          title: Link
      type: object
      required:
        - query
      title: RelatedSearch
      description: Related search suggestion.
    Pagination:
      properties:
        current:
          anyOf:
            - type: integer
            - type: string
          title: Current
          default: 1
        next:
          anyOf:
            - type: string
            - type: 'null'
          title: Next
        total_results:
          anyOf:
            - type: integer
            - type: 'null'
          title: Total Results
        total_pages:
          anyOf:
            - type: integer
            - type: 'null'
          title: Total Pages
        page_no:
          additionalProperties:
            type: string
          type: object
          title: Page No
      type: object
      title: Pagination
      description: Pagination metadata.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    Sitelink:
      properties:
        title:
          title: Title
          type: string
        link:
          anyOf:
            - type: string
            - type: 'null'
          title: Link
        snippet:
          anyOf:
            - type: string
            - type: 'null'
          title: Snippet
      type: object
      required:
        - title
      title: Sitelink
      description: A sitelink within an organic result.
    InlineSitelink:
      properties:
        title:
          anyOf:
            - type: string
            - type: 'null'
          title: Title
        date:
          anyOf:
            - type: string
            - type: 'null'
          title: Date
      type: object
      title: InlineSitelink
      description: An inline sitelink (e.g. Reddit post metadata).
    RichSnippet:
      description: >-
        Rich-snippet lines on a result. ``top`` sits between the URL and the
        snippet.
      properties:
        top:
          anyOf:
            - $ref: '#/components/schemas/RichSnippetBlock'
            - type: 'null'
          default: null
      title: RichSnippet
      type: object
    RichSnippetBlock:
      description: >-
        The extension line Google prints on a result, e.g. a store's rating
        line.
      properties:
        extensions:
          description: >-
            The line's parts in order ("4.6", "store rating (3.6K)", "$59 to
            $379").
          items:
            type: string
          title: Extensions
          type: array
        detected_extensions:
          additionalProperties:
            anyOf:
              - type: number
              - type: integer
              - type: string
          description: >-
            Values read out of the line: rating, reviews, price_from, price_to,
            currency, day_returns, free_day_returns, items_up_to_off.
          title: Detected Extensions
          type: object
      title: RichSnippetBlock
      type: object
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.