google-event-search
3.9
google-event-search is hosted online, so all tools can be tested directly either in theInspector tabor in theOnline Client.
If you are the rightful owner of google-event-search and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
Aigeon AI Google Event Search is a Python-based server application that uses the SerpApi to facilitate event searches via Google's event search engine.
# Aigeon AI Google Event Search
Aigeon AI Google Event Search is a Python-based server application designed to facilitate the search for events using the Google Events search engine. This application leverages the SerpApi to provide detailed event search capabilities, allowing users to customize their queries based on various parameters such as location, language, and event type.
## Features Overview
- **Event Search**: Utilize Google's event search engine to find events based on user-defined queries.
- **Customizable Parameters**: Tailor your search with a variety of parameters including location, language, and event type.
- **Pagination Support**: Navigate through search results using pagination.
- **Cache Management**: Control caching behavior to optimize search performance.
- **Asynchronous Search**: Optionally perform searches asynchronously for improved efficiency.
## Main Features and Functionality
The application is built around a primary function that interacts with the SerpApi to perform event searches. It provides a flexible interface for users to specify search criteria and retrieve event data in a structured format.
### Main Functionality
- **Search Event**: The core functionality of the application is encapsulated in the `search_event` function, which allows users to perform detailed event searches using a variety of customizable parameters.
## Main Functions Description
### `search_event`
The `search_event` function is the main tool provided by the application to perform event searches. It utilizes the SerpApi to query the Google Events search engine and returns the results in JSON format. Below is a detailed description of its parameters:
- **q**: (str) The search query string. Include location in the query for location-specific searches (e.g., "Events in Austin, TX").
- **location**: (str, optional) Specifies the origin location for the search. If omitted, a default proxy location may be used.
- **uule**: (str, optional) Google encoded location for the search. Cannot be used simultaneously with the `location` parameter.
- **google_domain**: (str, optional) Defines the Google domain to use, defaulting to `google.com`.
- **gl**: (str, optional) Two-letter country code to specify the country for the search.
- **hl**: (str, optional) Two-letter language code to define the language for the search.
- **start**: (int, optional) Result offset for pagination, accepts multiples of 20 for desktop and 10 for mobile.
- **htichips**: (str, optional) Filter parameter for event types and dates (e.g., "date:today" for today's events).
- **no_cache**: (bool, optional) Controls caching behavior; set to `true` to bypass cache.
- **aasync**: (bool, optional) Enables asynchronous search submission, allowing results to be retrieved later.
This function constructs a payload with the specified parameters and sends a GET request to the SerpApi, returning the search results in JSON format.
---
This README provides an overview of the Aigeon AI Google Event Search application, highlighting its main features and functionality. For further details, please refer to the code documentation and comments within the source code.