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 Control Center.
Request
HTTP Request
GET https://api.predicthq.com/v1/events/
Query parameters
Parameter
Description
Mapping File
Below is a CSV of all supported airport codes and their respective place_id.
Response
Response Fields
JSON Schema
Example response
Below is an example of a single result.
{"count":1,"overflow":false,"next":null,"previous":null,"results": [ {"relevance":0.0,"id":"5uRg7CqGu7DTtu4Rfk","parent_event": {"parent_event_id":"w7dYyrFwTUQGYE6euv" },"title":"Formula 1 2019 - United States Grand Prix 2019 - Race", "description": "The 2019 United States Grand Prix (officially known as the Formula 1 Emirates United States Grand Prix 2019) was a Formula One motor race held on 3 November 2019 at the Circuit of the Americas in Austin, Texas, United States. The race was the 19th round of the 2019 Formula One World Championship (1 - 3 Nov) and marked the 49th running of the United States Grand Prix.",
"category":"sports","labels": ["auto-racing","f1","sport" ],"rank":92,"local_rank":100,"phq_attendance":120000,"entities": [ {"entity_id":"dh6tCwHCRjZUNmzaviVw5g","name":"Carlos Sainz Jr","type":"person" }, {"entity_id":"fqGj7EdaKsDPGFUgsYhYWq","name":"Kevin Magnussen","type":"person" }, {"entity_id":"e5rtDESKg4fLpHzmTcdAxy","name":"Alexander Albon","type":"person" }, {"entity_id":"DtXbSrLe9Mb9BQfjzt8q3Q","name":"Sergio Perez","type":"person" }, {"entity_id":"32wsZ6AhQTmehuPV9KwqgCY","name":"Lewis Hamilton","type":"person" }, {"entity_id":"hdqmJpv6pbCNT5RMLjiQr8","name":"Lando Norris","type":"person" }, {"entity_id":"dXA6AvcgEg7W5SJdjcgAAG","name":"Lance Stroll","type":"person" }, {"entity_id":"sn3aet9XXYWPu2RmNMVsAG","name":"Daniil Kvyat","type":"person" }, {"entity_id":"hKiTqaaffAzV4wGntE6LH8","name":"Robert Kubica","type":"person" }, {"entity_id":"eG36WTqRtMwvjHM7SLHwiG","name":"Antonio Giovinazzi","type":"person" }, {"entity_id":"JpFCtMes9vVbXxKduZ9jTd","name":"Nicholas Latifi","type":"person" }, {"entity_id":"fS2HcqsbnzuCtXgUqch6Py","name":"Max Verstappen","type":"person" }, {"entity_id":"dMezEeCcEa9T7RscX4aBmg","name":"Valtteri Bottas","type":"person" }, {"entity_id":"DhfPt6zSSUjUrWWfCpukkY","name":"Sebastian Vettel","type":"person" }, {"entity_id":"fdX7zyHMKYjAjJhSKhAvaG","name":"Charles Leclerc","type":"person" }, {"entity_id":"XS7dVfwZBETRejm7en3Adg","name":"Pierre Gasly","type":"person" }, {"entity_id":"33RfRSKSNRfuAzAYWEV8mR8","name":"George Russell","type":"person" }, {"entity_id":"e5rv77Gws6cKNCmJra5VFy","name":"Daniel Ricciardo","type":"person" }, {"entity_id":"7NT7S5KqiwqdKZiwsydzz8","name":"Nico Hulkenberg","type":"person" }, {"entity_id":"MasUgUJtWz3kQFVgCG6rJU","name":"Circuit of the Americas","type":"venue","formatted_address":"9201 Circuit of the Americas Boulevard, Austin, TX 78617, United States of America" } ],"duration":7200,"start":"2019-11-03T19:10:00Z","end":"2019-11-03T21:10:00Z","updated":"2023-06-02T16:21:48Z","first_seen":"2019-07-04T22:14:31Z","timezone":"America/Chicago","location": [-97.63585109999997,30.1345808 ],"geo": {"geometry": {"coordinates": [-97.63585109999997,30.1345808 ],"type":"Point" },"placekey":"@8t2-fgg-dqf","address": {"country_code":"US","formatted_address":"9201 Circuit of the Americas Boulevard, Austin, TX 78617, United States of America","postcode":"78617","locality":"Austin","region":"Texas" } },"scope":"locality","country":"US","place_hierarchies": [ ["6295630","6255149","6252001","4736286","4737316","4689116" ], ["6295630","6255149","6252001","4736286","4737316","4671654" ] ],"state":"active","private":false,"predicted_event_spend":11806680,"predicted_event_spend_industries": {"accommodation":5016960,"hospitality":4924000,"transportation":1865720 } } ]}
