Serp API

SpaceSerp API can extract clean structured data from Google in real-time.

API playground

With our powerful API playground, you can quickly and flexibly configure requests. Just fill in some fields and we'll generate a request for you.

SpaceSerp API Playground

Making Requests

You can scrape any data from Google search via this endpoint.

GET https://api.spaceserp.com/google/search

Query Parameters

Name	Type	Description
apiKey*	String	An account API key that used to authorize user API requests.
q*	String	The keyword which you want to search.

200: OK Structured SERP Data

{
  "organic_results": [
    {
      "position": 1,
      "domain": "www.macrumors.com",
      "link": "https://www.macrumors.com/roundup/iphone-14/",
      "title": "iPhone 14: Just Launched! New 'Plus' Size ... - MacRumors",
      "description": "13 Oct 2022 — The new 6.7-inch iPhone 14 is called the \"iPhone 14 Plus,\" harkening back to the iPhone 8 and 8 Plus and prior generations. Apple's iPhone 14 ..."
    }
  ],
  "shopping_carousel": [
    {
      "position": 1,
      "title": "Apple Iphone 14 Pro, 128Gb",
      "price": "£1,099.00",
      "seller_name": "Very"
    }
  ],
  "ads_results": [
    {
      "position": 1,
      "domain": "www.apple.com",
      "link": "https://www.apple.com/uk/iphone-14/",
      "title": "The new iPhone 14 - Apple Official Site",
      "description": "Big and bigger. Buy now. 0% financing available. 5 colours. Longest battery life ever. A15 Bionic chip. Crash Detection.‎Buy now · ‎Apple Trade In · ‎Compare iPhone models · ‎Switch to iPhone · ‎Tech Specs"
    }
  ]
}

Below is a quick overview of all the parameters we support for Google searches. They should be appended as query parameters to the above request.

Parameter	Description
apiKey	An account API key that used to authorize user API requests. Note: Required parameter.
q	The keyword which you want to search. Note: Required parameter.
location	Location in which the query is executed. You can get a full list of available locations here.
domain	Google domain that performs the search. You can find a full list of the available domains here. Note: Default value: google.com.
gl	Indicate the country of the Google result page. Full list of the available gl parameters you can find here. Note: Default value : us.
hl	Specify the interface language for the Google search result page. Full list of the available hl parameters you can find here. Note: Default value: en.
resultFormat	Results format. Possible values: json, csv, html. Note: Default value: json.
device	The device which performed search requests. Possible values: desktop, mobile, tablet. Note: Default value: desktop.
mobileOs	Mobile OS. Possible values: ios, android. Note: Should be used with device=true.
pageSize	The number of results shown per page. Note: Should be from 1 to 100.
pageNumber	Number of the page of results to return.

Location

The location parameter is used to localize your query. You can use any string, but for increase accuracy, you should choose supported by Google value. There are several ways to do this:

SpaceSerp API Playground.

Just start fill location input and we'll pick up right value for you.

Location parameter

Locations Autocomplete API

Find related Google locations.

GET https://api.spaceserp.com/google/locations

Query Parameters

Name	Type	Description
apiKey*	String	An account API key that used to authorize user API requests.
q*	String	Search string
pageSize	Number	Default 10
pageNumber	String	Default 1

200: OK List of Google Locations

{
  "meta": {
    "pageNumber": 1,
    "pageSize": 10,
    "totalItems": 34,
    "totalPages": 4
  },
  "data": [
    {
      "_id": "62d53be936e0946cea6ae216",
      "criteriaId": 1006886,
      "name": "London",
      "canonicalName": "London,England,United Kingdom",
      "parentId": 20339,
      "countryCode": "GB",
      "targetType": "City",
      "status": "Active"
    },
    {
      "_id": "62d53be936e0946cea6ae217",
      "criteriaId": 1006887,
      "name": "London Colney",
      "canonicalName": "London Colney,England,United Kingdom",
      "parentId": 20339,
      "countryCode": "GB",
      "targetType": "City",
      "status": "Active"
    },
    {
      "_id": "62d53be936e0946cea6ae3a2",
      "criteriaId": 1007284,
      "name": "Londonderry",
      "canonicalName": "Londonderry,Northern Ireland,United Kingdom",
      "parentId": 20341,
      "countryCode": "GB",
      "targetType": "City",
      "status": "Active"
    }
  ]
}

Google domains

You can find a full list of the available domains in CSV file or via API Playground.

5KB

Google Domains.csv

Open

Google domains list

Google countries

You can find a full list of the available google countries in CSV file or via API Playground.

4KB

Google Countries.csv

Open

Google countries list

Google languages

You can find a full list of the available google languages in CSV file or via API Playground.

2KB

Google Languages.csv

Open

Google language list