> ## 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 Search: Search > Search from Google Search. Costs 1 credit per successful call. 1 credit per successful call; failed calls are free. See the [Google Search API overview](https://perceptlayer.com/apis/google-search) for every Google Search endpoint. ## OpenAPI ````yaml /openapi.json get /v1/google-search/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-search/search: get: tags: - Google Search summary: Search description: Search from Google Search. Costs 1 credit per successful call. operationId: google_search_search parameters: - name: query in: query required: true schema: type: string example: best restaurants in Berlin - name: location in: query required: false schema: type: string maxLength: 500 - name: uule in: query required: false schema: type: string maxLength: 500 - name: google_domain in: query required: false schema: type: string maxLength: 50 - name: gl in: query required: false schema: type: string maxLength: 2 - name: cr in: query required: false schema: type: string maxLength: 200 - name: hl in: query required: false schema: type: string maxLength: 2 example: en - name: lr in: query required: false schema: type: string maxLength: 200 - name: ludocid in: query required: false schema: type: string maxLength: 500 - name: lsig in: query required: false schema: type: string maxLength: 500 - name: kgmid in: query required: false schema: type: string maxLength: 500 - name: si in: query required: false schema: type: string maxLength: 500 - name: ibp in: query required: false schema: type: string maxLength: 500 - name: uds in: query required: false schema: type: string maxLength: 500 - name: oq in: query required: false schema: type: string maxLength: 2000 - name: sclient in: query required: false schema: type: string maxLength: 2000 - name: gs_lp in: query required: false schema: type: string maxLength: 2000 - name: tbs in: query required: false schema: type: string maxLength: 500 - name: as_qdr in: query required: false schema: type: string - name: safe in: query required: false schema: type: string enum: - active - 'off' example: 'off' - name: nfpr in: query required: false schema: type: integer enum: - '0' - '1' - name: filter in: query required: false schema: type: integer enum: - '0' - '1' - name: tbm in: query required: false schema: type: string enum: - isch - vid - nws - lcl - shop - pts - name: udm in: query required: false schema: type: integer enum: - '14' - name: start in: query required: false schema: type: integer - name: include_thumbnails in: query required: false schema: type: string enum: - '0' - '1' - 'true' - 'false' - name: page in: query required: false schema: type: integer - name: amount in: query required: false schema: type: integer - name: device in: query required: false schema: type: string enum: - desktop - tablet - mobile - name: proxy_country in: query required: false schema: type: string enum: - pl 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: endpoint: type: string params: type: object properties: query: type: string hl: type: string safe: type: string response: type: object properties: search_information: type: object properties: query_displayed: type: string organic_results_count: type: integer organic_results: type: array items: type: object properties: position: type: integer title: type: string link: type: string redirect_link: type: string displayed_link: type: string snippet: type: string snippet_highlighted_words: type: array items: type: string source: type: string rank_group: type: integer rank_absolute: type: integer related_searches: type: array items: type: object properties: query: type: string link: type: string people_also_search_for: type: array items: type: object properties: name: type: string query: type: string link: type: string related_questions: type: array items: type: object properties: question: type: string next_page_token: type: string local_results: type: object properties: places: type: array items: type: object properties: position: type: integer title: type: string rating: type: number reviews: type: integer reviews_original: type: string price: type: string type: type: string website: type: string phone: type: string address: type: string kgmid: type: string hours: type: string rank_absolute: type: integer modules: type: array items: type: object properties: title: type: string place_indexes: type: array items: type: integer rank_group: type: integer rank_absolute: type: integer organic_results_count: type: integer engine_used: type: string filters: type: array items: type: object properties: label: type: string link: type: string pagination: type: array items: type: object properties: start: type: integer link: type: string search_url: type: string serp_results: type: array items: type: object properties: type: type: string module_index: type: integer rank_group: type: integer rank_absolute: type: integer service_used: type: string description: >- The fields of a recorded response. Other responses can carry more, or leave some out. example: 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 '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.