Guides
Filtering Events
Learn how to filter events to find exactly what you need.
The GlobalEventBase API offers filtering capabilities to help you narrow down the events returned by the API.
Filter by Country
The primary way to filter events is by country using the country query parameter.
Usage
Provide the ISO 3166-1 alpha-2 code of the country you are interested in.
GET /api/events?country={ISO2_CODE}Examples
Get events in the United States (US):
curl "https://globaleventbase.com/api/events?country=US"Get events in the United Kingdom (GB):
curl "https://globaleventbase.com/api/events?country=GB"Get events in Japan (JP):
curl "https://globaleventbase.com/api/events?country=JP"Default Behavior
If the country parameter is not specified, the API defaults to returning events for the United States (US).
Future Filters
We are actively working on adding more filters, including:
- Category: Filter by event type (e.g., Sports, Music, Tech).
- Date Range: Filter events occurring within a specific time frame.
Check back soon for updates!