Web Search

0.5 credits

Get structured Google search results via a simple API. Supports web and image search with pagination.

POST/api/v1/tools/google/search

Parameters

qstringrequired

Search query

numnumber

Number of results per request, 1–10 (default 10). Maximum 10 per request.

startnumber

Pagination offset, 1–91 (starts at 1). Use with num to page through up to ~100 results.

glstring

Country code for results (e.g. "us", "gb")

hlstring

Language code for interface (e.g. "en", "fr")

searchTypestring

"web" (default) or "image". Set to "image" to search Google Images.

Response Schema

dataobject

Search results

totalResultsstring

Total number of results

searchTimenumber

Search duration in seconds

itemsobject[]

Array of search results

spellingobject

Spelling suggestion (if any)

nextStartnumber

Start index for next page

metaobject

Request metadata

toolstring

Tool name (search)

creditsUsednumber

Credits consumed (0.5)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/google/search \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{"q": "best coffee shops in tokyo", "num": 5}'

Response Example

{
  "data": {
    "totalResults": "12400000",
    "searchTime": 0.32,
    "items": [
      {
        "title": "Best Coffee Shops in Tokyo - TimeOut",
        "url": "https://www.timeout.com/tokyo/restaurants/best-coffee-shops-in-tokyo",
        "displayUrl": "www.timeout.com",
        "snippet": "Discover the best coffee shops in Tokyo, from specialty roasters to cozy kissaten..."
      }
    ],
    "nextStart": 6
  },
  "meta": {
    "tool": "google-search",
    "creditsUsed": 0.5,
    "requestId": "req_abc123"
  }
}