Google Logo Google Search API

With our Google Search API you can scrape Google Search Result Pages (SERP) with a single API call.

Each successful Google Search API request costs 25 credits

1. Quickstart

The Google Search API endpoint is https://scraperbox.com/api/google
You can send a GET or POST request.

Note that you should replace YOUR_API_TOKEN with your API token.

2. Authentication

Add the token field to the request to authenticate yourself.

https://scraperbox.com/api/google?token=YOUR_API_TOKEN

Alternatively you can set your token in the Authorization header.

Authorization: YOUR_API_TOKEN

3. Parameters

Parameter Type Default Description
q string '' The search query
proxy_location string 'all' The location to use. Use a 2 letter country code, see alpha-2 for a complete list.
results number 10 The number of results to return. Must be between 10 and 100.
offset number 0 The offset of search results. For example: use offset=10 te search the second page.
return_html boolean false If true then the endpoint will add a html field to the response with the HTML of the Google search result page.

4. API Response

The API will return the following JSON response.

{
    "organic_results": [
        {
            "position": 0,
            "title": "Undetectable Web Scraping API | ScraperBox",
            "link": "https://scraperbox.com",
            "displayed_link": "scraperbox.com",
            "snippet": "We make scraping fun with our easy to use web scraping API."
        },
        // etc...
    ],

    // If no ads are found this is omitted.
    "ads": [
        {
            "position": 0,
            "title": "A Paid Advertisement Title",
            "link": "https://mypaidwebsite.com",
            "displayed_link": "mypaidwebsite.com",
            "snippet": "Click on this paid ad!",
            "block_position": "top" // top or bottom
        },
        // etc...
    ],

    // If no local_results are found this is omitted.
    "local_results": [
        {
            "position": 0,
            "title": "Pizzeria ScraperBox",
            "address": "221B Baker Street",
            "review_score": 4.3
        },
        // etc...
    ],

    "search_information": {
        "total_results": 100000
    },

    // Only added if return_html is true
    "html": "The HTML of the search result page."
}

5. Errors

If the API fails it will return a 4xx or 500 status, along with a JSON error response.

For example, if you supplied the wrong API token, the API returns the following.

{
    "errors": {
        "token": "Invalid API token provided."
    }
}