Google Search

Scrape real-time Google Search results and receive clean, structured JSON — organic results, ads, related searches, knowledge graph, and more.

Actor

scraper.google.search

Common Parameters

Passed inside the input object. See API Parameters for the full list.

Parameter	Required	Description
`q`	true	The search query. Supports advanced operators such as `inurl:`, `site:`, `intitle:`.
`gl`	false	Two-letter country code for the search (e.g., `us`, `uk`, `fr`).
`hl`	false	Two-letter language code for the search (e.g., `en`, `es`, `fr`).
`google_domain`	false	The Google domain to use. Defaults to `google.com`.
`location`	false	Where the search should originate from (city-level recommended).
`start`	false	Result offset for pagination (`0`, `10`, `20`, …).

Request Example

curl 'https://api.scrapeless.com/api/v1/scraper/request' \
--header 'x-api-token: {your_api_key}' \
--header 'Content-Type: application/json' \
--data '{
    "actor": "scraper.google.search",
    "input": {
        "q": "coffee",
        "hl": "en",
        "gl": "us",
        "google_domain": "google.com"
    }
}'

import { Scrapeless } from '@scrapeless-ai/sdk';
 
const client = new Scrapeless({
  apiKey: 'YOUR_API_KEY'
});
 
client.deepserp.createTask({
    actor: "scraper.google.search",
    input: {
        q: "coffee",
        gl: "us",
        hl: "en",
        google_domain: "google.com"
    }
}).then((result) => {
    console.log(result);
  })
  .catch((error) => {
    console.error('Error:', error);
  });

import json
import requests
 
def send_request():
    host = "api.scrapeless.com"
    url = f"https://{host}/api/v1/scraper/request"
    token = "your_api_key"
 
    headers = {
        "x-api-token": token,
        "Content-Type": "application/json"
    }
 
    json_payload = json.dumps({
        "actor": "scraper.google.search",
        "input": {
            "q": "coffee",
            "gl": "us",
            "hl": "en",
            "google_domain": "google.com"
        }
    })
 
    response = requests.post(url, headers=headers, data=json_payload)
 
    if response.status_code != 200:
        print("Error:", response.status_code, response.text)
        return
 
    print("body", response.text)
 
if __name__ == "__main__":
    send_request()

Getting Started