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.

Making Requests

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

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

Query Parameters

NameTypeDescription

apiKey*

String

An account API key that used to authorize user API requests.

q*

String

The keyword which you want to search.

{
  "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.

ParameterDescription

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.

Locations Autocomplete API

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

Query Parameters

NameTypeDescription

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

{
  "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.

Google countries

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

Google languages

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

Last updated