> ## Documentation Index > Fetch the complete documentation index at: https://docs.perceptlayer.com/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Perceptlayer is a web data API: one key for structured JSON from about 250 websites. Base URL https://api.perceptlayer.com. > Send the key in the X-API-Key header. GET parameters go in the query string; POST parameters in a JSON body. > A successful call costs the credits on its endpoint (X-Credits-Used); failed calls cost nothing. Errors are {"error": {"code", "message", "request_id"}}. > AI agents can use every endpoint through the MCP server at https://api.perceptlayer.com/mcp (tools search_endpoints, get_endpoint, call_endpoint), with Authorization: Bearer . > Get a free key at https://perceptlayer.com/signup. # Google Maps: Simple Search > Simple Search from Google Maps. Costs 1 credit per successful call. 1 credit per successful call; failed calls are free. See the [Google Maps API overview](https://perceptlayer.com/apis/google-maps) for every Google Maps endpoint. ## OpenAPI ````yaml /openapi.json get /v1/google-maps/simple-search openapi: 3.1.0 info: title: Perceptlayer API version: 1.0.0 description: >- One API key for structured web data. Each successful call costs the credits shown on its endpoint; failed calls are free. servers: - url: https://api.perceptlayer.com security: - ApiKeyAuth: [] tags: - name: 99acres - name: Agoda - name: Airbnb - name: AliExpress - name: Apartments.com - name: Apple App Store - name: Aramisauto - name: Arbeitsagentur Jobs - name: Argenprop - name: Autohero - name: AutoScout24 - name: AutoTempest - name: AutoTrack.nl - name: Autotrader - name: AutoTrader.ca - name: AutoTrader UK - name: AutoUncle - name: Autovit - name: Baidu - name: Bandcamp - name: Bayut - name: Behance - name: Bien'ici - name: Bilbasen - name: Bilibili - name: Billiger.de - name: Bing - name: Blocket Bil - name: Bluesky - name: Boliga - name: Booking.com - name: Booli - name: Brave Search - name: Bring a Trailer - name: Capterra - name: CarDekho - name: CarGurus - name: CarMax - name: Cars & Bids - name: Cars.com - name: Cars24 - name: Carsales - name: Carvana - name: Carwow - name: Casa.it - name: Centris - name: Coches.net - name: Copart - name: Craigslist - name: Crexi - name: Daft.ie - name: Dailymotion - name: DBA - name: Depop - name: DeviantArt - name: Dice - name: Domain Availability - name: Domain.com.au - name: Dribbble - name: Dubizzle - name: DuckDuckGo - name: eBay - name: Economy Car Rentals - name: Edmunds - name: Eventbrite - name: Expedia - name: Facebook - name: Facebook Ad Library - name: Fincaraiz - name: FINN - name: FINN Bil - name: Flickr - name: FlixBus - name: Fotocasa - name: Geizhals - name: Genius - name: GetYourGuide - name: GitHub - name: Glassdoor - name: Goodreads - name: Google Ads Transparency - name: Google Events - name: Google Finance - name: Google Flights - name: Google Forums - name: Google Hotels - name: Google Images - name: Google Jobs - name: Google Lens - name: Google Local - name: Google Local Services - name: Google Maps - name: Google News - name: Google Patents - name: Google Play - name: Google Related Questions - name: Google Scholar - name: Google Search - name: Google Shopping - name: Google Short Videos - name: Google Translate - name: Google Travel Explore - name: Google Trends - name: Google Videos - name: Gumtree - name: Habitaclia - name: Hacker News - name: Hemnet - name: heycar - name: HolidayCheck - name: Holidu - name: Homegate - name: HomeToGo - name: Hostelworld - name: HotPads - name: IAAI - name: Idealista - name: Idealo - name: Imgur - name: ImmobilienScout24 - name: ImmobilienScout24 Austria - name: ImmoScout24 Switzerland - name: Immoweb - name: Immowelt - name: Imovirtual - name: Impressum Extraction - name: Indeed - name: InfoJobs - name: Inmuebles24 - name: Instagram - name: Jameda - name: Kavak - name: Kayak Flights - name: Kayak - name: Kelley Blue Book - name: Kick - name: Kijiji - name: Kiwi.com - name: Kleinanzeigen - name: kununu - name: Kwai - name: La Centrale - name: Leboncoin Autos - name: Leboncoin Immo - name: Lemmy - name: Letterboxd - name: Link in Bio - name: LinkedIn - name: Linktree - name: LLM Answers - name: LoopNet - name: Madlan - name: MagicBricks - name: Marktplaats - name: Marktplaats Autos - name: Mastodon - name: Medium - name: Mercado Libre - name: Metrocuadrado - name: Milanuncios - name: Mixcloud - name: mobile.de - name: Motors.co.uk - name: MyAnimeList - name: Naukri - name: Naver - name: North Data - name: Odysee - name: OfferUp - name: Ohne-Makler - name: OLX Poland - name: Omio - name: OnTheMarket - name: Otodom - name: Otomoto - name: Patreon - name: Pinterest - name: Private Property - name: Product Hunt - name: Property Finder - name: realestate.com.au - name: Realtor.ca - name: Redfin - name: Reed - name: Rentalcars.com - name: Rentalia - name: Ricardo - name: Rightmove - name: Rumble - name: SEEK - name: SeLoger - name: Semrush - name: Similarweb - name: Skyscanner - name: Snapchat - name: SoundCloud - name: SpareRoom - name: Spotahome - name: Spotify - name: Sreality - name: Standvirtual - name: Startpage - name: Steam - name: StepStone - name: Subito - name: Subito Motori - name: Substack - name: SuperCasa - name: Telegram - name: Threads - name: TikTok - name: Trade Me Property - name: Trainline - name: Tripadvisor - name: Trivago - name: TrueCar - name: Trulia - name: Trusted Shops - name: Trustpilot - name: Truth Social - name: Tumblr - name: tutti.ch - name: Twitch - name: Viator - name: Vimeo - name: Vinted - name: VivaReal - name: VK - name: Vrbo - name: Wallapop - name: Walmart - name: Web Scraper - name: Weibo - name: Welcome to the Jungle - name: WG-Gesucht - name: willhaben - name: wlw - name: X (Twitter) - name: XING Jobs - name: Yad2 - name: Yaencontre - name: Yahoo Search - name: Yelp - name: YouTube - name: Zillow - name: Zonaprop - name: Zoopla - name: Zumper paths: /v1/google-maps/simple-search: get: tags: - Google Maps summary: Simple Search description: Simple Search from Google Maps. Costs 1 credit per successful call. operationId: google_maps_simple_search parameters: - name: query in: query required: true schema: type: string example: restaurants in new york - name: hl in: query required: false schema: type: string - name: gl in: query required: false schema: type: string - name: google_domain in: query required: false schema: type: string maxLength: 100 - name: limit in: query required: false schema: type: integer - name: page in: query required: false schema: type: integer - name: fields in: query required: false schema: type: string responses: '200': description: Success headers: X-Request-Id: $ref: '#/components/headers/RequestId' X-Credits-Used: $ref: '#/components/headers/CreditsUsed' X-Credits-Remaining: $ref: '#/components/headers/CreditsRemaining' RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' RateLimit-Policy: $ref: '#/components/headers/RateLimitPolicy' content: application/json: schema: type: object properties: items: type: array items: type: object properties: name: type: string review_count: type: integer rating: type: number website: type: string domain: type: string latitude: type: number longitude: type: number business_id: type: string subtypes: type: array items: type: string district: type: string full_address: type: string timezone: type: string owner_id: type: string owner_name: type: string owner_link: type: string order_link: type: string google_mid: type: string phone_numbers: type: array items: type: string place_id: type: string photos_sample: type: array items: type: object properties: photo_id: type: string photo_url: type: string photo_url_large: type: string latitude: type: number longitude: type: number type: type: string neighborhood: type: string street_address_alt: type: string street_address_full: type: string city: type: string zip_code: type: string state: type: string country_code: type: string attributes: type: object properties: accessibility: type: object properties: Wheelchair-accessible entrance: type: boolean Wheelchair-accessible seating: type: boolean Wheelchair-accessible toilet: type: boolean Assistive hearing loop: type: boolean Wheelchair-accessible car park: type: boolean short_description: type: string full_description: type: string pagination: type: object properties: current_page: type: integer total_results: type: integer has_more: type: boolean description: >- The fields of a recorded response. Other responses can carry more, or leave some out. example: items: - name: Altair Restaurant NYC review_count: 1225 rating: 4.8 website: https://www.altairnyc.com/ domain: altairnyc.com latitude: 40.7556565 longitude: -73.9936282 business_id: 0x89c2591598891521:0x4ebcde18610e64 subtypes: - New American restaurant - Restaurant district: Manhattan full_address: 351 W 38th St, New York, NY 10018, United States timezone: America/New_York owner_id: '107444272980109255975' owner_name: Altair Restaurant NYC (Owner) owner_link: https://maps.google.com/maps/contrib/107444272980109255975 order_link: >- https://www.google.com/maps/reserve/v/dine/c/x4b2hrHtPNo?source=pa&opi=79508299&hl=en-DK&gei=SL3Yaqu_H4THwPAPp-aPwQE&ahbb=1&sourceurl=https://www.google.com/search?tbm%3Dmap%26hl%3Den%26pb%3D!4m8!1m3!1d5000!2d11.9373824!3d57.67168!2m3!1f0!2… google_mid: /g/11l1ncyn3_ phone_numbers: - +1 929-561-6131 place_id: ChIJIRWJmBVZwokRZA5hGN68TgA= photos_sample: - photo_id: CIABIhBYc3BDxCaQc_uFKXR3OdWZ photo_url: >- https://lh3.googleusercontent.com/grass-cs/AABkmLclIWNWEpHAS_ZfLzHbhgdk-n-vOqv2qRY9cg2EiOVnCBtZi80Si0nxJWS1y-q7erapIjJZ1lJeeR51ptN57lu8jInPLk371gnTlvHosWLJAHxRBUNaa0wp5Sus3H7K-Nm4ESp4yEDtLWrk=w86-h114-k-no photo_url_large: >- https://lh5.googleusercontent.com/p/CIABIhBYc3BDxCaQc_uFKXR3OdWZ?w3024-h3024-k-no latitude: 40.75565649230674 longitude: -73.99362817600482 type: photo neighborhood: Manhattan street_address_alt: 351 W 38th St street_address_full: 351 W 38th St city: New York zip_code: '10018' state: New York country_code: US attributes: accessibility: Wheelchair-accessible entrance: true Wheelchair-accessible seating: true Wheelchair-accessible toilet: true - name: Lulla NYC review_count: 1571 rating: 4.8 website: http://www.lullanyc.com/ domain: lullanyc.com latitude: 40.7441117 longitude: -73.99299409999999 business_id: 0x89c259bf22ca32bd:0x35d818a560181b20 subtypes: - Italian restaurant - Restaurant district: Manhattan full_address: 113 W 24th St, New York, NY 10011, United States timezone: America/New_York owner_id: '114181353879818223269' owner_name: Lulla NYC (Owner) owner_link: https://maps.google.com/maps/contrib/114181353879818223269 order_link: >- https://www.google.com/maps/reserve/v/dine/c/Jdtwk-1WpiY?source=pa&opi=79508299&hl=en-DK&gei=SL3Yaqu_H4THwPAPp-aPwQE&ahbb=1&sourceurl=https://www.google.com/search?tbm%3Dmap%26hl%3Den%26pb%3D!4m8!1m3!1d5000!2d11.9373824!3d57.67168!2m3!1f0!2… google_mid: /g/11ks6mqp8n phone_numbers: - +1 929-588-8556 place_id: ChIJvTLKIr9ZwokRIBsYYKUY2DU= photos_sample: - photo_id: CIHM0ogKEICAgIDvycftjQE photo_url: >- https://lh3.googleusercontent.com/grass-cs/AABkmLc0kk7d1qFcNbV0VXBb0neL3nT1j-VleIt2_krC3AKshr8xev_546j5whP6m60MyrSVwsRaQ8Tk1Z6rzorgyCNyn7Kz6OwF4f9Y45KK2sm_7dh9h4PsBRMiTdtwsnqskLopaaJfwA=w86-h107-k-no photo_url_large: >- https://lh5.googleusercontent.com/p/CIHM0ogKEICAgIDvycftjQE?w3024-h3024-k-no latitude: 40.744111702947535 longitude: -73.99299412410348 type: photo neighborhood: Manhattan street_address_alt: 113 W 24th St street_address_full: 113 W 24th St city: New York zip_code: '10011' state: New York country_code: US attributes: accessibility: Wheelchair-accessible entrance: true Wheelchair-accessible seating: true Wheelchair-accessible toilet: true - name: Manhatta review_count: 4127 rating: 4.7 website: https://www.manhattarestaurant.com/restaurant-menu/ domain: manhattarestaurant.com latitude: 40.707997399999996 longitude: -74.00888259999999 business_id: 0x89c25bc797d635a1:0x60b055910436a0a4 subtypes: - New American restaurant - Fine dining restaurant - Lounge bar district: Manhattan full_address: >- 28 Liberty St 60th floor, New York, NY 10005, United States timezone: America/New_York short_description: High-end New American meals on 60th floor full_description: >- Set on the 60th floor, this ritzy, high-end restaurant features New American cuisine and city views. owner_id: '100843555729741380380' owner_name: Manhatta (Owner) owner_link: https://maps.google.com/maps/contrib/100843555729741380380 order_link: >- https://www.google.com/maps/reserve/v/dine/c/pyjjUZqJ9lQ?source=pa&opi=79508299&hl=en-DK&gei=SL3Yaqu_H4THwPAPp-aPwQE&ahbb=1&sourceurl=https://www.google.com/search?tbm%3Dmap%26hl%3Den%26pb%3D!4m8!1m3!1d5000!2d11.9373824!3d57.67168!2m3!1f0!2… google_mid: /g/11gh9qhb9q phone_numbers: - +1 212-230-5788 place_id: ChIJoTXWl8dbwokRpKA2BJFVsGA= photos_sample: - photo_id: CIHM0ogKEICAgIC8-5qOlAE photo_url: >- https://lh3.googleusercontent.com/grass-cs/AABkmLc2zafZWAjljFYTzgo3_gXnvE35c6VTSU68XztRX0lD4yTiK8Rky0O4KAro8HQjPM1vMJmebZrji8rOmsLT9meoBNhvBcmhmE-BPd37mCw8CZKvcvjITdXNBu_Q0dxQV_f5UtyunA=w128-h86-k-no photo_url_large: >- https://lh5.googleusercontent.com/p/CIHM0ogKEICAgIC8-5qOlAE?w3024-h3024-k-no latitude: 40.70799741807325 longitude: -74.00888262951247 type: photo neighborhood: Manhattan street_address_alt: 28 Liberty St 60th floor street_address_full: 28 Liberty St 60th floor city: New York zip_code: '10005' state: New York country_code: US attributes: accessibility: Wheelchair-accessible entrance: true Wheelchair-accessible seating: true Wheelchair-accessible toilet: true Assistive hearing loop: false Wheelchair-accessible car park: false pagination: current_page: 0 total_results: 173 has_more: false '401': $ref: '#/components/responses/Error' '402': $ref: '#/components/responses/Error' '403': $ref: '#/components/responses/Error' '404': $ref: '#/components/responses/Error' '410': $ref: '#/components/responses/Error' '422': $ref: '#/components/responses/Error' '429': $ref: '#/components/responses/Error' '502': $ref: '#/components/responses/Error' '503': $ref: '#/components/responses/Error' '504': $ref: '#/components/responses/Error' components: headers: RequestId: description: Unique ID for this request; quote it in support requests. schema: type: string CreditsUsed: description: Credits charged for this call (0 when it failed). schema: type: integer CreditsRemaining: description: Your balance after this call. schema: type: integer RateLimitLimit: description: >- Requests a minute your account may make: its rate in requests per second times 60. schema: type: integer RateLimitRemaining: description: Requests left in the current minute, shared by every key on the account. schema: type: integer RateLimitReset: description: Seconds until the current minute's count starts over. schema: type: integer RateLimitPolicy: description: The limit and its window in seconds, for example "300;w=60". schema: type: string responses: Error: description: Error content: application/json: schema: $ref: '#/components/schemas/Error' schemas: Error: type: object required: - error properties: error: type: object required: - code - message - request_id properties: code: type: string message: type: string request_id: type: string securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.