Search Events

The largest and most accurate source of global data.

Results are limited by your subscription

Please note that you will not receive an error when requesting a date range or location that is outside of your subscription settings.

This is sometimes confused with missing data. If you're not seeing the results you expect to see then please ensure your subscription covers the location or time period you're searching for.

Your subscription settings can be viewed in our .

Examples

Make sure to properly load your access token from an environment variable or other secure method.

from predicthq import Client

phq = Client(access_token="$ACCESS_TOKEN")

for event in phq.events.search(
    place__scope=[5809844],
    category=["conferences", "expos", "concerts", "festivals", "performing-arts", "community", "sports"],
    active__gte="2025-02-01",
    active__lte="2025-04-01",
):
    print(event.rank, event.category, event.title, event.start.strftime("%Y-%m-%d"))

Make sure to properly load your access token from an environment variable or other secure method.

import requests

response = requests.get(
    url="https://api.predicthq.com/v1/events/",
    headers={
      "Authorization": "Bearer $ACCESS_TOKEN",
      "Accept": "application/json"
    },
    params={
        "category": "conferences,expos,concerts,festivals,performing-arts,community,sports",
        "place.scope": "5809844",
        "active.gte": "2025-03-01",
        "active.lte": "2025-04-01"
    }
)

print(response.json())

Make sure to properly load your access token from an environment variable or other secure method.

curl -X GET "https://api.predicthq.com/v1/events/?category=conferences,expos,concerts,festivals,performing-arts,community,sports&place.scope=5809844&active.gte=2025-03-01&active.lte=2025-04-01" \
     -H "Accept: application/json" \
     -H "Authorization: Bearer $ACCESS_TOKEN"

OpenAPI Spec

Guides

Below are some guides relevant to this API:

PreviousEvents NextGet Event Counts

Last updated 19 days ago

Was this helpful?

Examples

Make sure to properly load your access token from an environment variable or other secure method.

from predicthq import Client

phq = Client(access_token="$ACCESS_TOKEN")

for event in phq.events.search(
    place__scope=[5809844],
    category=["conferences", "expos", "concerts", "festivals", "performing-arts", "community", "sports"],
    active__gte="2025-02-01",
    active__lte="2025-04-01",
):
    print(event.rank, event.category, event.title, event.start.strftime("%Y-%m-%d"))

Make sure to properly load your access token from an environment variable or other secure method.

import requests

response = requests.get(
    url="https://api.predicthq.com/v1/events/",
    headers={
      "Authorization": "Bearer $ACCESS_TOKEN",
      "Accept": "application/json"
    },
    params={
        "category": "conferences,expos,concerts,festivals,performing-arts,community,sports",
        "place.scope": "5809844",
        "active.gte": "2025-03-01",
        "active.lte": "2025-04-01"
    }
)

print(response.json())

Make sure to properly load your access token from an environment variable or other secure method.

curl -X GET "https://api.predicthq.com/v1/events/?category=conferences,expos,concerts,festivals,performing-arts,community,sports&place.scope=5809844&active.gte=2025-03-01&active.lte=2025-04-01" \
     -H "Accept: application/json" \
     -H "Authorization: Bearer $ACCESS_TOKEN"

{ "count": 1, "overflow": true, "previous": "https://api.predicthq.com/v1/events/?limit=10&offset=10", "next": "https://api.predicthq.com/v1/events/?limit=10&offset=20", "results": [ { "brand_safe": true, "cancelled": null, "category": "academic", "country": "US", "deleted_reason": "cancelled", "description": "See Katy Perry in concert [...]", "duplicate_of_id": null, "duration": 3600, "end": null, "end_local": null, "entities": [ { "entity_id": "39yXYp4LvTW8TicddxHSiXw", "type": "event-group", "labels": [ "recurring" ], "name": "Underwood Family Farms Fall Harvest Festival", "recurring": { "ical": "DTSTART;VALUE=DATE-TIME:20170930T090000 DURATION:P31DT9H RRULE:FREQ=YEARLY;INTERVAL=1" } } ], "first_seen": null, "id": "z13B3870YOgv", "impact_patterns": { "vertical": "accommodation", "impact_type": "phq_rank", "impacts": [ { "date_local": "2025-05-12", "value": 1, "position": "leading" } ] }, "local_rank": null, "location_confidence_score": null, "geo": { "geometry": { "type": "Point", "coordinates": [ 174.776792, -36.847319 ] }, "placekey": "222-229@8t2-fgc-z2k", "address": { "country_code": "US", "formatted_address": "2350 Beach Blvd, Biloxi, MS 39531, USA", "locality": "Biloxi", "region": "Mississippi", "postcode": "39531" } }, "parent_event": { "parent_event_id": "w7dYyrFwTUQGYE6euv" }, "phq_attendance": 2511, "phq_labels": [ { "label": "agriculture-forestry-and-fisheries", "weight": 0.376 }, { "label": "food-and-beverage", "weight": 0.263 }, { "label": "art-and-cultural", "weight": 0.186 }, { "label": "science-and-technology", "weight": 0.175 } ], "place_hierarchies": [ [ "6295630", "6255148", "2635167", "6269131", "3333178", "2641170" ] ], "postponed": "2025-05-12T00:15:19.955Z", "predicted_end": "2025-05-12T00:15:19.955Z", "predicted_end_local": "2025-05-12T00:15:19.955Z", "predicted_event_spend": 11806680, "predicted_event_spend_industries": { "accommodation": 5016960, "hospitality": 4924000, "transportation": 1865720 }, "rank": 83, "relevance": 2.9654586, "scope": "locality", "start": null, "start_local": null, "start_date_confidence_score": null, "state": "active", "timezone": "Pacific/Auckland", "title": "Katy Perry", "updated": "2025-05-12T00:15:19.955Z" } ] }