WEB DATA

Google Search

Retrieve structured Google results for a query, location, language, and device.

POSThttps://api.sukidata.com/v1/serp

QUICKSTART

Make a request

Send your API key in the Authorization header and your search settings as JSON.

cURL

curl --request POST \
  --url https://api.sukidata.com/v1/serp \
  --header "Authorization: Bearer $SUKIDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "q": "coffee shops in seattle",
    "location": "Seattle, Washington, United States",
    "hl": "en",
    "device": "desktop"
  }'

REQUEST BODY

Common parameters

qstring · required

Search query. Google operators such as site:, inurl:, and intitle: are supported.

locationstring

Supported Google location name or ID. Use the location lookup endpoint to find exact values.

google_domain gl hlstring

Google domain, two-letter country code, and interface language. Defaults are google.com, us, and en.

devicestring

desktop, tablet, or mobile. The default is desktop.

tbmstring

Google result type, including images, local, videos, news, shopping, and patents. Omit it for regular web search.

startinteger

Zero-based result offset. The default is 0.

asyncboolean

Set to true to receive the search ID immediately and query the result later. Defaults to false.

View every Google Search parameter in the API Reference

RESPONSE

Structured search results

A completed response includes search metadata and the result groups present on the Google page.

search_metadataRequest status, identifiers, timing, and result file links.

search_parametersNormalized parameters used for the search.

organic_resultsRanked organic results with titles, links, and snippets.

answer_box knowledge_graphEnhanced result blocks when Google returns them.

local_results top_storiesLocal and news-oriented groups when present.

paginationAvailable navigation details for later result pages.

Asynchronous responsesIf search_metadata.status is Queued or Processing, query GET /v1/serp/{search_id} using search_metadata.id.

BILLING

Credit usage

Google Search uses Web Data credits. Read X-Sukidata-Credits-Used for the final charge. See Web Data billing for rates and free responses.

Need help with a request? Email support@sukidata.com and include the X-Request-ID response header.