Skip to main content

The Official Holiday and Event API for Python

Project description

The Official Holiday and Event API for Python

PyPI Supported Versions Build Status Code Coverage Known Vulnerabilities Funding Status

Industry-leading Holiday and Event API for Python. Over 5,000 holidays and thousands of descriptions. Trusted by the World’s leading companies. Built by developers for developers since 2011.

Supported Python Versions

Latest version of the the Holiday and Event API supports all actively-maintained Python releases and might work with older versions. It also supports PyPy versions 3.7, 3.8, and 3.9.


Access to the Holiday and Event API requires an API Key. You can get for one for FREE here, no credit card required! Note that free plans are limited. To access more data and have more requests, a paid plan is required.


The Holiday and Event API is available on PyPI:

$ python -m pip install holiday-event-api


import holidays

    # Get a FREE API key from
    client = holidays.client('<Your API Key Here>')

    # Get Events for a given Date
    events = client.getEvents(
        # These parameters are the defaults but can be specified:
        # date='today',
        # timezone='America/Chicago',
        # adult=False,

    event =[0]
    print(f"Today is {}! Find more information at: {event.url}.")
    print(f"Rate limits remaining: {events.rateLimit.remainingMonth}/{events.rateLimit.limitMonth} (month).")

    # Get Event Information
    eventInfo = client.getEventInfo(,
        # These parameters can be specified to calculate the range of eventInfo.Event.Occurrences
        # start=2020,
        # end=2030,

    print(f"The Event's hashtags are {eventInfo.event.hashtags}.")

    # Search for Events
    query = "pizza day"
    search =
        # These parameters are the defaults but can be specified:
        # adult=False,

    print(f"Found {len(} events, including {[0].name}, that match the query '{query}'.")
except Exception as e:
    print(f"There was an error: {e}")

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

holiday-event-api-1.0.1.tar.gz (6.1 kB view hashes)

Uploaded source

Built Distribution

holiday_event_api-1.0.1-py3-none-any.whl (6.1 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page