Documentation

Complete guide to using Euro Hackathons platform, API, and services

Browse Hackathons

Discover and filter European hackathons with advanced search

REST API

Access hackathon data programmatically with our API

Notifications

Get notified of new hackathons via Discord, Telegram, Twitter

Getting Started

Euro Hackathons is a comprehensive platform for discovering hackathons across Europe. Our system automatically scans and aggregates hackathon information, providing you with the most up-to-date listings.

Key Features

🔄 Automated Updates: New hackathons discovered 3-4 times daily
🔍 Advanced Filtering: Search by location, topics, dates, and status
🤖 Real-time Notifications: Discord, Telegram, and Twitter bots
📊 RESTful API: Access data programmatically
📱 Responsive Design: Works perfectly on all devices

Using the Platform

Browsing Hackathons

The main interface displays hackathons in an easy-to-browse card format. Each card shows:

• Event Name: Full hackathon title
• Location: City and country
• Dates: Start and end dates (if available)
• Topics: Relevant tags (AI, Crypto, Web3, etc.)
• Notes: Additional event details and requirements
• Registration Link: Direct link to sign up

Filtering Options

Search

Find hackathons by name using the search box

Status

Toggle between upcoming and past events

Location

Filter by specific cities or countries

Topics

Select multiple topics of interest

Date Range

Choose specific date ranges for your search

API Documentation

Our REST API provides programmatic access to hackathon data. The API is free to use with reasonable rate limits.

Base URL

https://euro-hackathons.vercel.app/api

Endpoints

GET/hackathons

Retrieve hackathons with optional filtering

Query Parameters

• status - Filter by status (upcoming, past, estimated)

Example Request

GET /api/hackathons?status=upcoming

Response Format

{ "data": [ { "id": "uuid", "name": "AI Hackathon Munich", "city": "Munich", "country_code": "DE", "date_start": "2025-06-15T09:00:00+00:00", "date_end": "2025-06-16T18:00:00+00:00", "topics": ["AI", "Machine Learning"], "notes": "Bring your laptop and creativity!", "url": "https://example.com/hackathon", "status": "upcoming" }, ... ] }

Rate Limiting

The API implements reasonable rate limiting to ensure fair usage:

• Free usage: 100 requests per hour per IP
• Burst limit: 10 requests per minute
• Commercial usage: Contact us for higher limits

Error Codes

400

Bad Request

Invalid query parameters

429

Too Many Requests

Rate limit exceeded

500

Internal Server Error

Server-side error

503

Service Unavailable

Temporary maintenance

Notification Services

Stay updated with new hackathons through our automated notification services. We support multiple platforms to reach you wherever you are.

Discord Bot

Join our Discord server for real-time hackathon notifications with rich embeds

Join Server

Telegram Channel

Follow our Telegram channel for mobile-friendly notifications

Join Channel

Twitter Updates

Follow @EuroHackathons

Notification Features

⚡ Real-time alerts: Get notified within minutes of discovery
📋 Rich information: Complete event details in notifications
🏷️ Topic filtering: Discord server supports topic-based channels
🔗 Direct links: One-click access to registration pages

Technical Architecture

Euro Hackathons is built with modern technologies to ensure reliability, performance, and scalability.

Technology Stack

Frontend

• Next.js 15 with App Router
• TypeScript
• Tailwind CSS
• shadcn/ui components

Backend

• Next.js API Routes
• Supabase (PostgreSQL)
• Row Level Security

Infrastructure

• Vercel deployment
• GitHub Actions CI/CD
• Cron job automation
• Multiple bot integrations

Update Frequency

Our automated system runs multiple times daily to ensure fresh data:

• Weekdays: 4 times daily
• Weekends: 3 times daily

Contributing

Euro Hackathons is an open-source project and we welcome contributions from the community!

How to Contribute

Report Issues: Found a bug or missing hackathon? Open an issue
Code Contributions: Fork the repository and submit pull requests
Feature Requests: Propose new features or improvements

Development Setup

# Clone the repository

git clone https://github.com/lorenzopalaia/Euro-Hackathons.git

# Install dependencies

npm install

# Set up environment variables

cp .env.example .env.local

# Run development server

npm run dev

Support & Community

Need help or have questions? Here&qpos;s how to get in touch with our community:

GitHub Issues

Best for bug reports, feature requests, and technical discussions

Open Issue

Discord Community

Join our community for general discussions and real-time support

Join Discord

Frequently Asked Questions

How often is the data updated?

Our automated system scans for new hackathons 3-4 times daily. The exact schedule varies between weekdays and weekends to optimize for when new events are typically announced.

Can I submit a hackathon that's missing?

Yes! Please open an issue on our GitHub repository with the hackathon details, and we'll add it manually to our database.

Is the API free to use?

Yes, our API is free for reasonable personal and small-scale commercial use. We have rate limits in place to ensure fair usage for everyone.

How do you determine if a hackathon is "European"?

We filter events based on location data. Events must be physically located in European countries or be explicitly targeted at the European community.

Can I use this data for my own project?

Yes! Our API is designed for this purpose. Please respect our rate limits and consider mentioning Euro Hackathons as your data source.

For additional questions or support, don't hesitate to reach out through any of our community channels. We're here to help! 🚀