Serpnodeserpnode

Search Endpoint

Use this endpoint to perform a Google search. Supports verticals via the tbm parameter.

GET/POST/v1/search

You can call this endpoint via GET or POST.

Required attributes

  • Name
    q
    Type
    string
    Description

    Search query.

Optional attributes

  • Name
    location
    Type
    string
    Description
    Human-readable location (uule generation is currently disabled).
  • Name
    search_engine
    Type
    string
    Description
    Google domain to use (e.g. google.com).
  • Name
    hl
    Type
    string
    Description
    Interface language code.
  • Name
    gl
    Type
    string
    Description
    Country code.
  • Name
    lr
    Type
    string
    Description
    Language restricts results (e.g. lang_en).
  • Name
    cr
    Type
    string
    Description
    Country restricts results.
  • Name
    safe
    Type
    string
    Description
    Safe search: active or off.
  • Name
    start
    Type
    integer
    Description
    Start index for pagination (>= 0)
  • Name
    tbs
    Type
    string
    Description
    Time-based search (e.g. qdr:m).
  • Name
    adtest
    Type
    boolean
    Description
    Test ads flag.
  • Name
    filter
    Type
    string
    Description
    Duplicate filtering: 0 or 1.
  • Name
    tbm
    Type
    string
    Description
    Search vertical: isch, vid, nws, lcl, pts, shop.
  • Name
    source
    Type
    string
    Description
    Custom source identifier.

Response shape

The response contains a metadata object with request params and a result object with snake_cased data from Serper.dev.

Request

GET
/v1/search
curl -G 'https://api.serpnode.com/v1/search' \
  --data-urlencode 'q=openai'
  -H 'apikey: YOUR-API-KEY'