Search Events for a Saved Location

Search for events happening in an existing Saved Location.

Request

HTTP Request

GET https://api.predicthq.com/v1/saved-locations//insights/events

Path Parameters

Parameter	Description
location_id	An existing Saved Location ID.

Query Parameters

Please refer to the Events API documentation for the available query parameters in addition to those listed below.

Parameter	Description
date_range_type string	Date range to fetch events for. Currently the only supported date ranges are: next_90d E.g. ?date_range_type=next_90d

Response

Response Fields

Field	Description
count number	Total number of results found.
results array	List of results where each item is an Event. Please refer to the response fields section in Search Events for the structure of each record.

Example response

Below is an example response:

{
  "count": 522,
  "results": [
    {
      "id": "8uPpWYtuLFKmdswgXL",
      "title": "Folsom Street Fair",
      "description": "The mission of Folsom Street Events is to create world-class leather and fetish events that unite the adult alternative lifestyle communities with safe venues for self-expression and exciting entertainment.",
      "entities": [
        {
          "formatted_address": "",
          "type": "event-group",
          "name": "Folsom Street Fair"
        }
      ],
      "place_hierarchies": [
        [
          "6295630",
          "6255149",
          "6252001",
          "5332921",
          "5391997",
          "5391959"
        ]
      ],
      "timezone": "America/Los_Angeles",
      "location": [
        -122.39231700000002,
        37.789024100000006
      ],
      "start": "2023-09-24T07:00:00Z",
      "end": "2023-09-25T06:59:59Z",
      "duration": 86399,
      "category": "festivals",
      "labels": [
        "entertainment",
        "festival"
      ],
      "phq_attendance": 400000,
      "rank": 100,
      "local_rank": 100,
      "geo": {
        "geometry": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -122.39120568030553,
                37.7903973041606
              ],
              [
                -122.39089017614494,
                37.79064318446613
              ],
              [
                -122.39039841553388,
                37.790012176144934
              ],
              [
                -122.39342831969448,
                37.787650895839406
              ],
              [
                -122.39374382385508,
                37.78740501553388
              ],
              [
                -122.39423558446613,
                37.78803602385507
              ],
              [
                -122.39120568030553,
                37.7903973041606
              ]
            ]
          ]
        }
      },
      "state": "active",
      "predicted_event_spend": 51223933,
      "predicted_event_spend_industries": {
        "accommodation": 24096533,
        "hospitality": 20882800,
        "transportation": 6244600
      }
    },
    {
      "id": "6VSWpModQLPewdbDx2",
      "title": "Dreamforce",
      "description": "Dreamforce gathers the entire Salesforce community — our customers, partners, employees, and key stakeholders — for a fun family reunion.",
      "entities": [
        {
          "formatted_address": "800 Howard Street\nSan Francisco, CA 94103\nUnited States of America",
          "type": "venue",
          "name": "Moscone Center - West"
        },
        {
          "formatted_address": "",
          "type": "event-group",
          "name": "Dreamforce"
        }
      ],
      "place_hierarchies": [
        [
          "6295630",
          "6255149",
          "6252001",
          "5332921",
          "5391997",
          "5391959"
        ]
      ],
      "timezone": "America/Los_Angeles",
      "location": [
        -122.403445,
        37.783197
      ],
      "start": "2023-09-12T17:00:00Z",
      "end": "2023-09-15T01:00:00Z",
      "duration": 201600,
      "category": "conferences",
      "labels": [
        "business",
        "conference",
        "sales",
        "technology"
      ],
      "phq_attendance": 170000,
      "rank": 95,
      "local_rank": 100,
      "geo": {
        "geometry": {
          "type": "Point",
          "coordinates": [
            -122.403445,
            37.783197
          ]
        },
        "placekey": "222@5vg-7gv-3t9"
      },
      "state": "active",
      "predicted_event_spend": 163214070,
      "predicted_event_spend_industries": {
        "accommodation": 112651293,
        "hospitality": 42600912,
        "transportation": 7961865
      }
    },
    ...
  ]
}

Examples

curl

curl --location 'https://api.predicthq.com/v1/saved-locations/0b6ZrOnTdB2Y7k4zC_9qBg/insights/events?date_range_type=next_90d&category=public-holidays%2Csports&sort=start' \
--header 'Authorization: Bearer TOKEN'

python

import requests

url = "https://api.predicthq.com/v1/saved-locations/0b6ZrOnTdB2Y7k4zC_9qBg/insights/events?date_range_type=next_90d&category=public-holidays,sports&sort=start"

payload={}
headers = {
  'Authorization': 'Bearer TOKEN'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Guides

Below are some guides relevant to this API:

• Working with Location-Based Subscriptions