Google Health Trends
This is the API documentation for accessing the Google Health Trends (ght)
endpoint of Delphi’s epidemiological data.
General topics not specific to any particular endpoint are discussed in the API overview. Such topics include: contributing, citing, and data licensing.
Google Health Trends Data
Estimate of influenza activity based on volume of certain search queries. This data may be useful for real-time monitoring of diseases, as in:
- Herman Anthony Carneiro, Eleftherios Mylonakis. Google Trends: A Web-Based Tool for Real-Time Surveillance of Disease Outbreaks. Clinical Infectious Diseases, Volume 49, Issue 10, 15 November 2009, Pages 1557–1564.
- Abel Brodeur, Andrew E. Clark, Sarah Fleche, Nattavudh Powdthavee. COVID-19, lockdowns and well-being: Evidence from Google Trends. Journal of Public Economics, Volume 193, 2021, 104346.
- Sudhakar V. Nuti, Brian Wayda, Isuru Ranasinghe, Sisi Wang, Rachel P. Dreyer, Serene I. Chen, Karthik Murugiah. The Use of Google Trends in Health Care Research: A Systematic Review, October 2014.
The API
The base URL is: https://api.delphi.cmu.edu/epidata/ght/
See this documentation for details on specifying epiweeks, dates, and lists.
Parameters
Required
| Parameter | Description | Type |
|---|---|---|
auth |
password | string |
epiweeks |
epiweeks | list of epiweeks |
locations |
locations | list of state and/or US labels |
query |
search query or topic ID (see https://www.freebase.com/) | string |
Response
| Field | Description | Type | |
|---|---|---|---|
result |
result code: 1 = success, 2 = too many results, -2 = no results | integer | |
epidata |
list of results | array of objects | |
| … | … | … | |
message |
success or error message |
string |