event-api-service 0.1.0
Unified Event API Service - Aggregate events from Eventbrite, Meetup, Ticketmaster, and more
Requires Python: >=3.7

# Event API Service

A unified Python API service that aggregates event data from multiple sources including Eventbrite, Meetup, Ticketmaster, AllEvents, SerpApi, and PredictHQ.

## Features

- 🎯 **Multi-Source Aggregation**: Fetch events from 6+ different providers
- 🔐 **Built-in Authentication**: API Key-based authentication
- ⚡ **Rate Limiting**: Configurable request limits
- 🌍 **Geocoding Support**: Automatic location resolution
- 📦 **Easy to Deploy**: Simple Flask-based architecture
- 🔧 **Configurable**: Environment-based configuration

## Installation

```bash
pip install event_api_service
```

## Quick Start

### 1. Set up environment variables

Create a `.env` file:

```bash
# API Keys for Event Providers (optional, configure as needed)
TICKETMASTER_KEY=your_ticketmaster_key
MEETUP_TOKEN=your_meetup_token
ALLEVENTS_KEY=your_allevents_key
SERPAPI_KEY=your_serpapi_key
PREDICTHQ_TOKEN=your_predicthq_token

# API Key for this service
API_KEY=your_secret_api_key
```

### 2. Run the server

```python
from dotenv import load_dotenv
from event_api import create_app

load_dotenv()
app = create_app()

if __name__ == '__main__':
    app.run(debug=True, port=5000)
```

### 3. Make requests

```bash
curl -H "x-api-key: your_secret_api_key" \
  "http://localhost:5000/api/v1/events?location=New York&category=music"
```

## API Documentation

### Authentication

All endpoints require an API Key in the request header:

```
x-api-key: your_secret_api_key
```

### Endpoints

#### GET /api/v1/events

Fetch events by location and category.

**Parameters:**
- `location` (string, required): City name (e.g., "New York", "London")
- `category` (string, required): Event category (e.g., "music", "tech", "sports")

**Response:**

```json
{
  "status": "success",
  "count": 15,
  "data": [
    {
      "id": "evt-123",
      "title": "Tech Conference 2025",
      "description": "Annual technology conference...",
      "start_time": "2025-12-01T09:00:00",
      "url": "https://example.com/event/123",
      "location": "Convention Center",
      "source": "eventbrite"
    }
  ]
}
```

## Supported Event Sources

| Provider | Configuration Required | Notes |
|----------|----------------------|-------|
| Eventbrite | No | Free, supports major US cities |
| Ticketmaster | `TICKETMASTER_KEY` | Music, sports, arts events |
| Meetup | `MEETUP_TOKEN` | Community events |
| AllEvents | `ALLEVENTS_KEY` | Global event aggregator |
| SerpApi | `SERPAPI_KEY` | Google Events search |
| PredictHQ | `PREDICTHQ_TOKEN` | Professional event data |

## Rate Limits

- 10 requests per minute
- 50 requests per hour
- 200 requests per day

## Python Client Example

```python
import requests

class EventAPIClient:
    def __init__(self, api_key, base_url="http://localhost:5000/api/v1"):
        self.api_key = api_key
        self.base_url = base_url
    
    def get_events(self, location, category):
        headers = {"x-api-key": self.api_key}
        params = {"location": location, "category": category}
        
        response = requests.get(
            f"{self.base_url}/events",
            headers=headers,
            params=params
        )
        return response.json()

# Usage
client = EventAPIClient(api_key="your_secret_api_key")
events = client.get_events("San Francisco", "tech")
print(f"Found {events['count']} events")
```

## Documentation

For complete API documentation, see [API_DOCUMENTATION.md](API_DOCUMENTATION.md)

## License

MIT License

## Support

For issues and questions, please open an issue on GitHub.