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
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
category
string
Comma-separated list of event categories to include.
Please refer to the category parameter in Events API.
E.g. ?category=sports,concerts
sort
string
Sort order for results.
Please refer to the sort parameter in Events API.
E.g. ?sort=phq_attendance
limit
number
The maximum number of results to return. The default limit is 10.
E.g. ?limit=10
offset
number
The number of results to skip. The default is 0.
E.g. ?offset=20
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 } }, ... ]}