> ## 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 Events: Search > Search from Google Events. Costs 1 credit per successful call. 1 credit per successful call; failed calls are free. See the [Google Events API overview](https://perceptlayer.com/apis/google-events) for every Google Events endpoint. ## OpenAPI ````yaml /openapi.json get /v1/google-events/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-events/search: get: tags: - Google Events summary: Search description: Search from Google Events. Costs 1 credit per successful call. operationId: google_events_search parameters: - name: q in: query required: true schema: type: string maxLength: 255 example: concerts in austin - name: hl in: query required: false schema: type: string example: en - name: gl in: query required: false schema: type: string maxLength: 2 example: us - name: location in: query required: false schema: type: string maxLength: 255 - name: uule in: query required: false schema: type: string maxLength: 500 - name: htichips in: query required: false schema: type: string maxLength: 200 - name: start in: query required: false schema: type: integer 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: q: type: string hl: type: string gl: type: string response: type: object properties: search_parameters: type: object properties: engine: type: string q: type: string gl: type: string hl: type: string start: type: integer search_information: type: object properties: events_results_state: type: string events_results: type: array items: type: object properties: position: type: integer title: type: string date: type: object properties: when: type: string start_time: type: string end_time: type: string address: type: array items: type: string link: type: string event_location_map: type: object properties: image: type: string link: type: string description: type: string ticket_info: type: array items: type: object properties: source: type: string link: type: string link_type: type: string venue: type: object properties: name: type: string rating: type: number reviews: type: integer link: type: string thumbnail: type: string price: type: string extracted_price: type: integer pagination: type: object properties: current_page: type: integer start: type: integer description: >- The fields of a recorded response. Other responses can carry more, or leave some out. example: endpoint: google-events.search params: q: events in london this weekend hl: en gl: uk response: search_parameters: engine: google_events q: events in london this weekend gl: uk hl: en start: 0 search_information: events_results_state: Results for exact spelling events_results: - position: 1 title: Halloween River Cruise date: when: Sat, 24 Oct 2026, 19:00 start_time: '2026-10-24T18:00:00Z' end_time: '2026-10-24T19:00:00Z' address: - >- Riverside Building, London Eye, County Hall, Westminster Bridge Rd, London SE1 7PB link: >- https://www.google.com/search?q=Halloween%20River%20Cruise&ibp=htl;events#fpstate=tldetail&htidocid=%2Fg%2F11p1p2jqd4 event_location_map: image: >- https://www.google.com/maps/vt/data=RQBgTLyMC69TCDgHBfTZwrGhJsdlPpvoll7nMm62Z10lrDi0-QM_3j3KuA58NFxapJaeTffpOKHaC_VoQhqIRvJrUZqO51aPpOAz2ir09x0rkcu68YRzH-SHTfU0NgRiaZTii8YZptd2RtRMjRAn_ZNDjGUd9lPOxJkhFg link: >- https://www.google.com/maps/search/?api=1&query=Riverside%20Building%2C%20London%20Eye%2C%20County%20Hall%2C%20Westminster%20Bridge%20Rd%2C%20London%20SE1%207PB description: >- A 60-minute London Eye River Cruise along the Thames with live actors telling ghost stories of Jack the Ripper, the ghost of Captain Kidd and the haunted cries of Old London Bridge. Suitable for children aged 5 and over, with a complimentar… ticket_info: - source: Mato Events link: >- https://ma.to/event/london-eye-halloween-river-cruise-2026-10-24 link_type: tickets - source: londoneye.com link: https://www.londoneye.com/ link_type: more info venue: name: London Eye rating: 4.5 reviews: 206031 link: >- https://www.google.com/search?q=London+Eye&ludocid=4796882358840715922 thumbnail: >- https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSIyGJkdedlIlKt-RDN0ud-FP177CCvK_cM-VDPtGilIsEngLzXTMXfTGmHpgIvc6S0f3hXZaJaUcgcI3w - position: 2 title: 'Wicked Westminster: The Original London Ghost Walk' date: when: Sun, 25 Oct 2026 start_time: '2026-10-24T23:00:00Z' end_time: '2026-10-24T23:00:00Z' address: - Constance Fund fountain of Diana - London SW1A 1RN link: >- https://www.google.com/search?q=Wicked%20Westminster%3A%20The%20Original%20London%20Ghost%20Walk&ibp=htl;events#fpstate=tldetail&htidocid=%2Fg%2F11nb85f4cp event_location_map: image: >- https://www.google.com/maps/vt/data=cuuFeFV7z5z-z57ca3dyNw_vfAvTaS5xUyGz0lK44C9U4tMFKWjDPtgK1WKD9YhBdTXASj04RqNCXnrmorv4-25xUDno2Un0RemVfM504V0BNrseizwSnfvTE64tIRm7UT4QVARYGR-f1x3hpkWUdgQZQH4faH7MS0UpWBXse-JL link: >- https://www.google.com/maps/search/?api=1&query=Constance%20Fund%20fountain%20of%20Diana%2C%20London%20SW1A%201RN description: >- Highlights ? Explore London?s haunted streets on an atmospheric evening ghost walk ?? Discover the site of London?s most haunted house ? End your chilling journey at the iconic and mysterious Tower of London General Info ? ticket_info: - source: CompareTheTicketPrice.com link: >- https://www.comparetheticketprice.com/performance/wicked-westminster:-the-original-london-ghost-walk/4732284 link_type: tickets - source: en.m.wikipedia.org link: >- https://en.m.wikipedia.org/wiki/Diana_Fountain,_Green_Park link_type: more info venue: name: Constance Fund fountain of Diana rating: 4.5 reviews: 151 link: >- https://www.google.com/search?q=Constance+Fund+fountain+of+Diana&ludocid=8627082062591940256 thumbnail: >- https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSAYNyt45WcUl0s7UfneGpBU9sKWVTGXjS8Wz3gi6OvjIyTiGU6xxY2q0967Mi87oNRo19IVCJau9VrZvw - position: 3 title: The Standard of Living date: when: Sat, 24 Oct 2026, 14:30 start_time: '2026-10-24T13:30:00Z' end_time: '2026-10-24T14:30:00Z' address: - Theatre Royal Haymarket - Haymarket, London SW1Y 4HT link: >- https://www.google.com/search?q=The%20Standard%20of%20Living&ibp=htl;events#fpstate=tldetail&htidocid=%2Fg%2F11zyzh36jm event_location_map: image: >- https://www.google.com/maps/vt/data=7SRepPKFRTZQB0kGrSd0B4_HlPumKi-bPM4ZbglHWX7-Xmr6YGLmFEM7QDSyRYbBElTTtfnhHNVydCWeboSpjM3cugXkhwymOxk9TrxV2ZLBkedSn3oinS9kGtzze2gg0yFqFaBdb8LZromH21akht56vZzWMmrAouLKwGyGi2aK link: >- https://www.google.com/maps/search/?api=1&query=Theatre%20Royal%20Haymarket%2C%20Haymarket%2C%20London%20SW1Y%204HT description: >-

Why watch The Standard of Living