Documentation
  • Getting Started
  • Serp API
  • Automation
  • What is credit?
Powered by GitBook
On this page
  • API playground
  • Making Requests
  • You can scrape any data from Google search via this endpoint.
  • Location
  • Find related Google locations.

Serp API

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

PreviousGetting StartedNextAutomation

Last updated 2 years ago

API playground

With our powerful , 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

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.

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

domain

gl

hl

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:

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

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

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

Google countries

Google languages

Location in which the query is executed. You can get a full list of available locations .

Google domain that performs the search. You can find a full list of the available domains . Note: Default value: google.com.

Indicate the country of the Google result page. Full list of the available gl parameters you can find . Note: Default value : us.

Specify the interface language for the Google search result page. Full list of the available hl parameters you can find . Note: Default value: en.

SpaceSerp .

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

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

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

API Playground
API Playground
API Playground
API Playground
here
here
here
here
API playground
5KB
Google Domains.csv
Google domains list
4KB
Google Countries.csv
Google countries list
2KB
Google Languages.csv
Google language list
SpaceSerp API Playground
Location parameter