find_event_recommendations
Discover personalized event recommendations by searching for performers, events, or locations. Use geo-location, coordinates, or postal codes to find nearby events, with optional date filters and pagination.
Instructions
Get personalized event recommendations based on performers, events, or location. This tool first searches for performers and/or events based on the query (q parameter), then uses the IDs to find similar events. Use location parameters (geoip, lat/lon, postal_code) for nearby events.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end_utc | No | End date filter in ISO8601 UTC format (YYYY-MM-DD). Use with start_utc to define date ranges. | |
| format | No | Output format. Use "structured" for readable format (default) or "json" for raw API response. Only use "json" if explicitly requested. | structured |
| geoip | No | Use IP geolocation to provide recommendations for events near the user. | |
| lat | No | Latitude coordinate for location-based recommendations. Use with lon and optionally range. | |
| lon | No | Longitude coordinate for location-based recommendations. Use with lat and optionally range. | |
| page | No | Page number for pagination. Default is 1. | |
| per_page | No | Number of results to return per page (1-50). Default is 10. | |
| postal_code | No | Postal code for location-based recommendations. Use with country code for better accuracy. | |
| q | No | Search query to find either an event or performer to base recommendations on. If provided, the system will first look up the event ID or performer ID/slug automatically. | |
| range | No | Search radius for location-based recommendations (e.g., "50mi", "25km"). Use with lat/lon or postal_code. | |
| start_utc | No | Start date filter in ISO8601 UTC format (YYYY-MM-DD). Use for date ranges like "next month" or "this weekend". |