API Reference

Google Search

Search Google and retrieve structured results with title, URL, and description. Every result carries a 'type' of 'organic' or 'paid'; the paid ones are the ads Google placed above and below the results, so filter on that field to get rankings alone. Supports search types (images, news, videos), time filters, and geographic targeting.

Use this to search Google programmatically and get structured results — no HTML parsing required. Returns titles, URLs, and descriptions for each result.

5 credits per request.

Quick example

curl -G "https://api.webscraperapi.ai/v1/google_search" \
  -H "Authorization: Bearer $WEBSCRAPERAPI_API_KEY" \
  --data-urlencode "query=best noise cancelling headphones 2026" \
  --data-urlencode "output=json"

Use search_type to filter by images (isch), news (nws), or videos (vid). Use time_period to restrict to recent results — great for monitoring mentions or tracking trends.

Full API reference

GET
/v1/google_search

Query Parameters

query*string

Search query.

Length1 <= length
domain?|

Google domain TLD (e.g., 'com', 'de', 'co.uk').

locale?|

Interface language in IETF BCP 47 (e.g., 'en-US').

geo_location?|

Geographic location (e.g., 'California,United States').

start_page?integer

Starting page number.

Default1
Range1 <= value
pages?integer

Number of pages to scrape. The ceiling is configured per deployment, and a request above it is rejected.

Default1
Range1 <= value
limit?|

Results per page (max 100).

tbm?|

Search type: 'isch' (images), 'nws' (news), 'vid' (videos), 'bks' (books).

tbs?|

Time/sort filters: 'qdr:d' (past day), 'qdr:w' (past week), 'li:1' (verbatim).

render_js?boolean

Whether to render JavaScript.

Defaultfalse
output?|

Output format. Falls back to Accept header when not provided.

timeout_ms?|

Request timeout in milliseconds.

Response Body

application/json

application/json

curl -X GET "https://api.webscraperapi.ai/v1/google_search?query=string"
null
{
  "error": {
    "code": "string",
    "message": "string",
    "details": {}
  }
}