Simple Search

Streamlined service for basic searches of locations, places, and points of interest on Google Maps.

Endpoint

GET /api/google-maps-api/simple-search

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Parameters

query string Required

The search term that the API will use.

limit integer Optional

Maximum number of results to return (1-200).

page integer Optional

Page number for pagination (0-based). Default: 0

hl string Optional

Language code for results. Default: en

gl string Optional

Country/region code for geo-filtering results.

google_domain string Optional

Google domain to use for the search (e.g., google.com, google.de).

Request Examples

<?php

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://scrappa.co/api/maps/simple-search?query=restaurants+in+new+york');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'x-api-key: YOUR_API_KEY_HERE',
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
<?php

use Illuminate\Support\Facades\Http;

$response = Http::withHeaders([
    'x-api-key' => 'YOUR_API_KEY_HERE',
])->get('https://scrappa.co/api/maps/simple-search?query=restaurants+in+new+york');

return $response->json();
fetch('https://scrappa.co/api/maps/simple-search?query=restaurants+in+new+york', {
  headers: {
    'x-api-key': 'YOUR_API_KEY_HERE'
  }
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));
const axios = require('axios');

axios.get('https://scrappa.co/api/maps/simple-search?query=restaurants+in+new+york', {
  headers: {
    'x-api-key': 'YOUR_API_KEY_HERE'
  }
})
  .then(response => console.log(response.data))
  .catch(error => console.error('Error:', error));
import requests

headers = {
    'x-api-key': 'YOUR_API_KEY_HERE'
}

response = requests.get('https://scrappa.co/api/maps/simple-search?query=restaurants+in+new+york', headers=headers)
print(response.json())
require 'net/http'
require 'uri'
require 'json'

uri = URI.parse('https://scrappa.co/api/maps/simple-search?query=restaurants+in+new+york')
request = Net::HTTP::Get.new(uri)
request['x-api-key'] = 'YOUR_API_KEY_HERE'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts JSON.parse(response.body)
package main

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

func main() {
    client := &http.Client{}
    req, _ := http.NewRequest("GET", "https://scrappa.co/api/maps/simple-search?query=restaurants+in+new+york", nil)
    req.Header.Set("x-api-key", "YOUR_API_KEY_HERE")

    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}
curl -X GET 'https://scrappa.co/api/maps/simple-search?query=restaurants+in+new+york' \
  -H 'x-api-key: YOUR_API_KEY_HERE'

Response Schema

JSON Response 200 OK
{
    "items": [
        {
            "name": "El Bolillo Bakery",
            "price_level": "\u20ac",
            "price_level_text": "Inexpensive",
            "review_count": 3690,
            "rating": 4.7,
            "website": "https://www.elbolillobakery.com",
            "domain": "elbolillobakery.com",
            "latitude": 29.7604,
            "longitude": -95.3698,
            "business_id": "0x8640b88f75b395a3:0x8771a1c312c0bd48",
            "subtypes": [
                "Bakery",
                "Cafe",
                "Coffee shop"
            ],
            "district": "Downtown",
            "full_address": "2421 Canal St, Houston, TX 77003",
            "timezone": "America/Chicago",
            "short_description": "Popular local bakery known for fresh bread and pastries",
            "full_description": "El Bolillo Bakery is a Houston favorite offering fresh baked goods daily.",
            "owner_id": "123456789012345678901",
            "owner_name": "El Bolillo Bakery (Owner)",
            "owner_link": "https://maps.google.com/maps/contrib/123456789012345678901",
            "order_link": "https://www.elbolillobakery.com/order",
            "google_mid": "/g/1tgb0z0z",
            "type": "Bakery",
            "phone_numbers": [
                "+1 713-226-8889"
            ],
            "place_id": "ChIJo5WzdY-4QIYRSL3AEsOhcYc",
            "photos_sample": [
                {
                    "photo_id": "AF1QipNx1234567890",
                    "photo_url": "https://lh3.googleusercontent.com/p/AF1QipNx...",
                    "photo_url_large": "https://lh5.googleusercontent.com/p/AF1QipNx...",
                    "video_thumbnail_url": null,
                    "latitude": 29.7604,
                    "longitude": -95.3698,
                    "type": "photo"
                }
            ],
            "opening_hours": [
                {
                    "day": "Monday",
                    "hours": [
                        "6:00 AM\u20138:00 PM"
                    ],
                    "date": null,
                    "special_day": null
                },
                {
                    "day": "Tuesday",
                    "hours": [
                        "6:00 AM\u20138:00 PM"
                    ],
                    "date": null,
                    "special_day": null
                }
            ],
            "current_status": "Open",
            "attributes": {
                "service_options": {
                    "Curbside pickup": true,
                    "Delivery": false,
                    "In-store pickup": true,
                    "In-store shopping": true,
                    "Takeout": true
                }
            },
            "neighborhood": "East Downtown",
            "street_address_alt": "2421 Canal St",
            "street_address_full": "2421 Canal Street",
            "city": "Houston",
            "zip_code": "77003",
            "state": "Texas",
            "country_code": "US"
        }
    ]
}

Try It Live

Test this endpoint in our interactive playground with real data.

Open in Playground