Skip to content

Google Mobile Search API

prod-global
GET
/api/v1/google/search/mobile

Scrape mobile-optimized Google search results to provide accurate mobile rankings, features, and layouts. Identify mobile-specific features like AMP results and touch-optimized snippets for a mobile-first SEO strategy.

Tags: Google API

Parameters

NameRequiredTypeDefaultDescription
queryYesstringThe search query for Google Search (e.g., 'coffee shops', 'how to bake a cake').
pageNointeger0The results page number. Use 0 for the first page, 1 for the second, and so on.
htmlNobooleanfalseSet to true to return the raw HTML of the Google search results page alongside the structured data.
languageNostringenSet the language for the results using its two-letter code (e.g., 'en' for English, 'fr' for French). See Google Language.
lrNostringRestrict results to one or more languages using the 'lang_{language_code}' format (e.g., 'lang_en'). See Google LR Language.
domainNostringgoogle.comThe Google domain to use for the search (e.g., 'google.com', 'google.co.uk'). See Google Domains.
countryNostringusSet the target country code (e.g., 'us', 'uk') to localize results. See Google Countries.
crNostringLimits results to search results from specific countries. Format: 'countryXX'. See Google CR Countries.
uuleNostringEncoded location string (UULE) used to precisely localize Google search results. This is an advanced/technical parameter — if you’re not familiar with it, you can leave it empty and omit it.
locationNostringThe textual location name (e.g., 'New York, NY') to localize the search results.
ludocidNostringGoogle local business CID (place identifier). Used to target a specific Google Business Profile / local listing. Advanced parameter — if you don’t know it, you can omit it.
lsigNostringSignature parameter (lsig) sometimes required for certain Knowledge Graph / local map view features. This is an advanced technical parameter — if you’re not familiar with it, you can leave it empty.
kgmidNostringKnowledge Graph entity/listing ID (KGMID) used to retrieve details for a specific entity. This is an advanced technical parameter — if you’re not familiar with it, you can leave it empty.
siNostringCached search context parameter (si) used to reproduce specific Google search result views/context (e.g. some Knowledge Graph tabs). This is an advanced technical parameter — if you’re not familiar with it, you can leave it empty.
ibpNostringParameter (ibp) used to control certain Google UI expansions or rendering modes (commonly in local/business result views). This is an advanced technical parameter — if you’re not familiar with it, you can leave it empty.
udsNostringAdvanced filter token (uds) used for specific Google search sub-filters. This is an advanced technical parameter, usually provided by Google in filter options/results — if you’re not familiar with it, you can leave it empty.
tbsNostringAdvanced search filter parameter (tbs) used to apply Google result filters (e.g. time range). This is an advanced parameter — if you’re not familiar with it, you can leave it empty.
safeNostringoffSafeSearch filter setting. Set to 'active' to filter adult content, or 'off' to disable it.
nfprNostring0Controls Google's auto-correction. Set to '1' to exclude corrected results, '0' to include them.
filterNostringToggle 'Similar Results' and 'Omitted Results' filters. Set to '1' (default) to enable, '0' to disable.

Copy Request

bash
curl -X GET "https://api.justserpapi.com/api/v1/google/search/mobile?query=coffee" \
  -H "X-API-Key: YOUR_API_KEY"
js
const res = await fetch("https://api.justserpapi.com/api/v1/google/search/mobile?query=coffee", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await res.json();
console.log(data);
python
import requests

url = "https://api.justserpapi.com/api/v1/google/search/mobile"
headers = { "X-API-Key": "YOUR_API_KEY" }
params = {
  "query": "coffee"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
php
<?php
$url = "https://api.justserpapi.com/api/v1/google/search/mobile?query=coffee";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-API-Key: YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
go
package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	client := &http.Client{}
	req, _ := http.NewRequest("GET", "https://api.justserpapi.com/api/v1/google/search/mobile?query=coffee", nil)
	req.Header.Set("X-API-Key", "YOUR_API_KEY")
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

Response

Example:

json
{
  "code": 200,
  "message": "success",
  "data": {
    "local_results": [
      {
        "position": 1,
        "title": "El Saraya Coffee shop",
        "rating": "4.1",
        "reviews": "81",
        "extensions": [
          "$1–10",
          "CafeOpen",
          "Jersey City, NJ ⁦\"Excellent quality ⁩⁦coffee⁩⁦, nice service, and authentic scenery\"⁩"
        ],
        "address": "Jersey City, NJ⁦\"Excellent quality ⁩⁦coffee⁩⁦, nice service, and authentic scenery\"⁩",
        "hours": "Open",
        "links": {}
      },
      {
        "position": 2,
        "title": "Jackie Coffee Co",
        "rating": "",
        "reviews": "",
        "extensions": [
          "CafeOpen",
          "Hoboken, NJ"
        ],
        "address": "Hoboken, NJ",
        "hours": "Open",
        "links": {}
      },
      {
        "position": 3,
        "title": "Haute Dulce",
        "rating": "4.9",
        "reviews": "1.2K",
        "extensions": [
          "$10–20",
          "CafeClosed",
          "Secaucus, NJ ⁦\"The ⁩⁦coffee⁩⁦ excellent and the atmosphere relax, simple and elegant.\"⁩"
        ],
        "address": "Secaucus, NJ⁦\"The ⁩⁦coffee⁩⁦ excellent and the atmosphere relax, simple and elegant.\"⁩",
        "hours": "Closed",
        "links": {}
      },
      {
        "more_locations_link": "https://www.google.com/search?q=coffee&sca_esv=977e0bbde19a8b17&gl=us&hl=en&udm=1&lsack=lVudad-ADNKf5NoPjvXekQc&sa=X&ved=2ahUKEwifn8W11fGSAxXSD1kFHY66N3IQxMEEegQIfRAB"
      }
    ],
    "peopleAlsoAskedFor": [],
    "organic_results": []
  },
  "requestId": "101aaebd-2812-4c3b-ad16-ea2daa4c7519",
  "timestamp": 1771920278597
}