Google Search: Search

curl --request GET \
  --url https://api.perceptlayer.com/v1/google-search/search \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.perceptlayer.com/v1/google-search/search"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.perceptlayer.com/v1/google-search/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const url = 'https://api.perceptlayer.com/v1/google-search/search';
const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

package main

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

func main() {

	url := "https://api.perceptlayer.com/v1/google-search/search"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.perceptlayer.com/v1/google-search/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

require 'uri'
require 'net/http'

url = URI("https://api.perceptlayer.com/v1/google-search/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

HttpResponse<String> response = Unirest.get("https://api.perceptlayer.com/v1/google-search/search")
  .header("X-API-Key", "<api-key>")
  .asString();

{
  "endpoint": "google-search.search",
  "params": {
    "query": "best restaurants in Berlin",
    "hl": "en",
    "safe": "off"
  },
  "response": {
    "search_information": {
      "query_displayed": "best restaurants in Berlin",
      "organic_results_count": 6
    },
    "organic_results": [
      {
        "position": 1,
        "title": "The Best Restaurants in Berlin - Food Guide & Map",
        "link": "https://andershusa.com/best-restaurants-berlin-germany-guide/",
        "redirect_link": "https://www.google.com/goto?url=CAESegHrOzAV7vOTOiRYGN3Rq_LJMgUCSUtmes2rLIk-rn2vHS6tGU7IIN38aZ1xjQeD3kZuDFfbW6QvUSum1Woyp6Hmrl5u9WEXLlEP2Ek60dzztg2yT13pxwC2ptSycsD8oNSMSvxL2hck34Si_FG5SkSccCgH6vSRyc1N",
        "displayed_link": "https://andershusa.com › best-restaurants-berlin-german...",
        "snippet": "Dec 3, 2025 — Tim Raue is the most internationally renowned restaurant in Berlin. It holds two Michelin stars, has been frequently ranked on The World's 50 ...",
        "snippet_highlighted_words": [
          "Tim Raue is the most internationally renowned restaurant in Berlin"
        ],
        "source": "Anders & Kaitlin",
        "rank_group": 1,
        "rank_absolute": 4
      },
      {
        "position": 2,
        "title": "Restaurants - Berlin",
        "link": "https://guide.michelin.com/us/en/berlin-region/berlin/restaurants",
        "redirect_link": "https://www.google.com/goto?url=CAESfgHrOzAV6jTRuX3nLXgahhXZH3LiGlT1I4wNpzChMtbrUrd3JO4tnHnqm7WSpMFXW7LBM_sJuhj8BBNBNf3WeDMOcBM-Oad-7F_dEXjjmHBMLWF-qrxcJ53HI7t8j8wIQWXnMWoECOXKVOEEHnX3HgyudL1nLCAGReV2JNpc1Q",
        "displayed_link": "https://guide.michelin.com › berlin-region › restaurants",
        "snippet": "Berlin and surroundings: 1-48 of 79 restaurants · POTS · Rutz · GOLVET · Bandol sur mer · Nobelhart & Schmutzig · Oukan · 136 · FACIL.",
        "snippet_highlighted_words": [
          "POTS"
        ],
        "source": "MICHELIN Guide",
        "rank_group": 2,
        "rank_absolute": 5
      },
      {
        "position": 3,
        "title": "8 nights in Berlin, mix of Michelin starred/trendy ...",
        "link": "https://www.reddit.com/r/finedining/comments/1rhfsx5/8_nights_in_berlin_mix_of_michelin_starredtrendy/",
        "redirect_link": "https://www.google.com/goto?url=CAESowEB6zswFcPUPFTd1mO27hFe0tpmz2f-BOT0hlWOHf2j-B0pOwmN4TORK-SzL40eAVunx8SVlOR1d1oIjH5APLY6ZZCwNpoCltSsdjO0YCy6Whr65g4238jgMB51lgK76Q6EQgilY-zUjOpaJXLzZGRg2KZqXWuflX336-q2qsI6qXwCbcl9v0MisjcM9lrS_bOJmgXfvfeR…",
        "displayed_link": "30+ comments  ·  7 months ago",
        "snippet": "Most memorable fine dining experience shared Rutz, Nobelhart & Schmutzig, Bieberbau, Lucky Leek, Osman's Tochter, Lokal, Nussbaumarin,",
        "snippet_highlighted_words": [
          "dining"
        ],
        "source": "Reddit · r/finedining",
        "rank_group": 3,
        "rank_absolute": 6
      }
    ],
    "related_searches": [
      {
        "query": "Best restaurants in Berlin for tourists",
        "link": "https://www.google.com/search?safe=off&gl=us&hl=en&complete=0&pws=0&nfpr=1&q=Best+restaurants+in+Berlin+for+tourists"
      },
      {
        "query": "Best affordable restaurants in Berlin",
        "link": "https://www.google.com/search?safe=off&gl=us&hl=en&complete=0&pws=0&nfpr=1&q=Best+affordable+restaurants+in+Berlin"
      },
      {
        "query": "Best restaurants in Berlin Mitte",
        "link": "https://www.google.com/search?safe=off&gl=us&hl=en&complete=0&pws=0&nfpr=1&q=Best+restaurants+in+Berlin+Mitte"
      }
    ],
    "people_also_search_for": [
      {
        "name": "Best restaurants in Berlin for tourists",
        "query": "Best restaurants in Berlin for tourists",
        "link": "https://www.google.com/search?safe=off&gl=us&hl=en&complete=0&pws=0&nfpr=1&q=Best+restaurants+in+Berlin+for+tourists"
      },
      {
        "name": "Best affordable restaurants in Berlin",
        "query": "Best affordable restaurants in Berlin",
        "link": "https://www.google.com/search?safe=off&gl=us&hl=en&complete=0&pws=0&nfpr=1&q=Best+affordable+restaurants+in+Berlin"
      },
      {
        "name": "Best restaurants in Berlin Mitte",
        "query": "Best restaurants in Berlin Mitte",
        "link": "https://www.google.com/search?safe=off&gl=us&hl=en&complete=0&pws=0&nfpr=1&q=Best+restaurants+in+Berlin+Mitte"
      }
    ],
    "related_questions": [
      {
        "question": "What is the coolest restaurant in Berlin?",
        "next_page_token": "fc=EqEBCmJBSmlUNHRMWjV0cUtnRWF3THBmd2poWERESG9Zd1NDdjV1eVBaTnlyQUpwWHptbXpvWEl3cEcteUc4clBmTmM2RmVqZ3gxeFBSR2Q2YnhWUXRYTV9fbU9TZ25Oa3RSM2JJQRIXZlBEYWFyWDFHc1RtN19VUDg3elAwUWcaIkFEc3I5ZlJIQ1hnUVBTMXlmWk54Y0huUXlGRUx4MUxxVlE&vet=12ahUKEwi1o5u…"
      },
      {
        "question": "What is famous to eat in Berlin?",
        "next_page_token": "fc=EqEBCmJBSmlUNHRMWjV0cUtnRWF3THBmd2poWERESG9Zd1NDdjV1eVBaTnlyQUpwWHptbXpvWEl3cEcteUc4clBmTmM2RmVqZ3gxeFBSR2Q2YnhWUXRYTV9fbU9TZ25Oa3RSM2JJQRIXZlBEYWFyWDFHc1RtN19VUDg3elAwUWcaIkFEc3I5ZlJIQ1hnUVBTMXlmWk54Y0huUXlGRUx4MUxxVlE&vet=12ahUKEwi1o5u…"
      },
      {
        "question": "Where is the best place to eat in Berlin?",
        "next_page_token": "fc=EqEBCmJBSmlUNHRMWjV0cUtnRWF3THBmd2poWERESG9Zd1NDdjV1eVBaTnlyQUpwWHptbXpvWEl3cEcteUc4clBmTmM2RmVqZ3gxeFBSR2Q2YnhWUXRYTV9fbU9TZ25Oa3RSM2JJQRIXZlBEYWFyWDFHc1RtN19VUDg3elAwUWcaIkFEc3I5ZlJIQ1hnUVBTMXlmWk54Y0huUXlGRUx4MUxxVlE&vet=12ahUKEwi1o5u…"
      }
    ],
    "local_results": {
      "places": [
        {
          "position": 1,
          "title": "BLESS Restaurant",
          "rating": 4.8,
          "reviews": 2400,
          "reviews_original": "(2.4K)",
          "price": "€20–70",
          "type": "Asian",
          "website": "https://bless-restaurants.com/",
          "phone": "+49 30 20619795",
          "address": "Hausvogteipl. 10, 10117 Berlin, Germany",
          "kgmid": "/g/11lkzg8dhv",
          "hours": "Closed · Opens 11:30 AM",
          "rank_absolute": 1
        },
        {
          "position": 2,
          "title": "Beast Berlin",
          "rating": 4.6,
          "reviews": 2000,
          "reviews_original": "(2K)",
          "price": "€30–80",
          "type": "Restaurant",
          "website": "https://beast-berlin.com/",
          "phone": "+49 30 25817696",
          "address": "Karl-Liebknecht-Str. 29, 10178 Berlin, Germany",
          "kgmid": "/g/11vzsjywwp",
          "hours": "Closed · Opens 5 PM",
          "rank_absolute": 2
        },
        {
          "position": 3,
          "title": "Coccodrillo",
          "rating": 4.7,
          "reviews": 20000,
          "reviews_original": "(20K)",
          "price": "€20–60",
          "type": "Italian",
          "website": "https://www.bigmammagroup.com/italian-restaurants/coccodrillo-berlin",
          "address": "Veteranenstraße 9, 10119 Berlin, Germany",
          "kgmid": "/g/11s32x3ylx",
          "hours": "Closed · Opens 12 PM",
          "rank_absolute": 3
        }
      ],
      "modules": [
        {
          "title": "Local results",
          "place_indexes": [
            0
          ],
          "rank_group": 1,
          "rank_absolute": 1
        },
        {
          "title": "Local results",
          "place_indexes": [
            1
          ],
          "rank_group": 2,
          "rank_absolute": 2
        },
        {
          "title": "Local results",
          "place_indexes": [
            2
          ],
          "rank_group": 3,
          "rank_absolute": 3
        }
      ]
    },
    "organic_results_count": 6,
    "engine_used": "google",
    "filters": [
      {
        "label": "Open now",
        "link": "https://www.google.com/search?safe=off&gl=us&hl=en&complete=0&pws=0&nfpr=1&q=best+restaurants+in+Berlin+open+now&uds=AJ5uw1_a2D0D09lxm8gpKKOTUn4rTalc9ibXQalw1qPNRsa2kYMWiMHImk4jH3ILBPQLmrcZQsHdKFh59Beb2vdttUK4ALC1SST_yOTm3JZqwlq_yq2Vo0bPPFm…"
      },
      {
        "label": "Cheap",
        "link": "https://www.google.com/search?safe=off&gl=us&hl=en&complete=0&pws=0&nfpr=1&q=cheap+best+restaurants+in+Berlin&uds=AJ5uw1_a2D0D09lxm8gpKKOTUn4rTalc9ibXQalw1qPNRsa2kYMWiMHImk4jH3ILBPQLmrcZQsHdKFh59Beb2vdttUK4ALC1SST_yOTm3JZqwlq_yq2Vo0bPPFmc6u…"
      },
      {
        "label": "Upscale",
        "link": "https://www.google.com/search?safe=off&gl=us&hl=en&complete=0&pws=0&nfpr=1&q=upscale+best+restaurants+in+Berlin&uds=AJ5uw1_a2D0D09lxm8gpKKOTUn4rTalc9ibXQalw1qPNRsa2kYMWiMHImk4jH3ILBPQLmrcZQsHdKFh59Beb2vdttUK4ALC1SST_yOTm3JZqwlq_yq2Vo0bPPFmc…"
      }
    ],
    "pagination": [
      {
        "start": 10,
        "link": "https://www.google.com/search?q=best+restaurants+in+Berlin&safe=off&gl=us&hl=en&complete=0&pws=0&nfpr=1&start=10&sstk=AS6-VmL_G_De8UiN3D_XAT3Ff4VskwGwzT2MMqsZ2e8Id6aLiqLds43x2TOBrteSsKA-QrI7FjWbdi-yvz_LAQGQ7pw0onrH8RtmYw"
      },
      {
        "start": 20,
        "link": "https://www.google.com/search?q=best+restaurants+in+Berlin&safe=off&gl=us&hl=en&complete=0&pws=0&nfpr=1&start=20&sstk=AS6-VmL_G_De8UiN3D_XAT3Ff4VskwGwzT2MMqsZ2e8Id6aLiqLds43x2TOBrteSsKA-QrI7FjWbdi-yvz_LAQGQ7pw0onrH8RtmYw"
      },
      {
        "start": 30,
        "link": "https://www.google.com/search?q=best+restaurants+in+Berlin&safe=off&gl=us&hl=en&complete=0&pws=0&nfpr=1&start=30&sstk=AS6-VmL_G_De8UiN3D_XAT3Ff4VskwGwzT2MMqsZ2e8Id6aLiqLds43x2TOBrteSsKA-QrI7FjWbdi-yvz_LAQGQ7pw0onrH8RtmYw"
      }
    ],
    "search_url": "https://www.google.com/search?q=best+restaurants+in+Berlin&gl=us&hl=en&safe=off&complete=0&pws=0&nfpr=1",
    "serp_results": [
      {
        "type": "local_results",
        "module_index": 0,
        "rank_group": 1,
        "rank_absolute": 1
      },
      {
        "type": "local_results",
        "module_index": 1,
        "rank_group": 2,
        "rank_absolute": 2
      },
      {
        "type": "local_results",
        "module_index": 2,
        "rank_group": 3,
        "rank_absolute": 3
      }
    ],
    "service_used": "google"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>"
  }
}