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.

Estimate of influenza activity based on volume of certain search queries. …

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  

Example URLs

Code Samples