Google Shopping

post/v1/shopping

Request

  • Base URL: https://api.serpkite.com
  • URL: https://api.serpkite.com/v1/shopping
  • Auth: HTTP bearer

Request body

qstring required
countrystring

Country code (ISO 3166-1 alpha-2, case-insensitive; uk is accepted as gb). When omitted and location ends in a country name, that country is used. Russia (ru) is supported across all search verticals, including patents, using the shared proxy routes

languagestring

Interface language: a language code with an optional region (e.g. en, ru, de, pt-br, zh-tw, es-419). Russian (ru) is supported across all search verticals; language does not change the selected country. On patents, a non-English code restricts publication language (ar, zh, da, nl, fi, fr, de, it, ja, ko, no, pt, ru, es, sv)

locationstring

Free-text location, e.g. "Austin, Texas, United States"

uulestring

Pre-encoded Google location (overrides ll and location; percent-encoded values are decoded)

llstring

Map point "@lat,lng,14z" (maps and places only; zoom optional): the search runs as a searcher at that point. Overrides location

numinteger

10, or up to 100 for the depth bundle on search and news (7 credits for 100; values between round up to whole pages). Other verticals return one page of 10

pageinteger
time'hour' | 'day' | 'week' | 'month' | 'year'

Only results from the last hour/day/… (search, news, images, videos, shopping). A fallback engine without that window is skipped, never answered unfiltered

tbsstring

Advanced: raw Google tbs filter (e.g. qdr:d, qdr:w2, cdr:1,cd_min:1/1/2026,cd_max:1/31/2026); overrides time

device'desktop' | 'mobile'
safe'active' | 'off'
autocorrectboolean
format'json' | 'markdown' | 'compact'
fieldsstring

Comma-separated projection, e.g. "results.title,results.link,knowledge_graph"

include_contentinteger

Also fetch the top N organic pages as Markdown (+1 credit each fetched page)

adsboolean

Include sponsored results

max_ageinteger

Accept a cached result up to this many seconds old (50% of credits on a hit)

start_datestring date

Only results published on or after this date, YYYY-MM-DD (search, news, images, videos). Can't be combined with time or tbs. A fallback engine without date ranges is skipped

end_datestring date

Only results published on or before this date, YYYY-MM-DD. Can't be combined with time or tbs

highlightsboolean

Return up to 3 query-ranked passages (highlights) of each page read by include_content instead of the whole page (search only; needs include_content; no extra credits)

Example request

{
  "engine": "google",
  "include_domains": "github.com,en.wikipedia.org",
  "exclude_domains": "github.com,en.wikipedia.org",
  "boost_domains": "github.com,en.wikipedia.org"
}

Response

OK (text/markdown when format=markdown)

Example response

{
  "request": {
    "endpoint": "search"
  },
  "meta": {
    "engine": "google",
    "route": [
      {
        "provider": "google"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.