Link Search Menu Expand Document

Survey Aggregates


Note: Aggregates for the API, map, and survey results page are shown for weighted countries only. Please find the complete list of countries that are weighted by Facebook here.
Microdata files include both weighted and unweighted countries. For more information on how to gain access to the microdata go here.


To get aggregates you need to make a call to the following url:

Version 2 API:

https://covidmap.umd.edu/apiv2/resources?indicator={indicator}&type={type}&country={country}&date={date}

Version 1 API: (depracated; without indicators added after wave 11)

https://covidmap.umd.edu/api/resources?indicator={indicator}&type={type}&country={country}&date={date}

Query Parameters

Parameter Description Example
indicator Aggregate data to query covid, mask, vaccine_acpt
type Aggregate data type to use daily or smoothed
country Country to query aggregates for Italy, Colombia, Autralia
region Region to query aggregates for (optional) Piemonte, Santander, New South Wales
date Used to query aggregate data for a specific day (V2:optional)20210101
daterange Used to query aggregates data within a time range (optional) 20210101-20210115

The mandatory parameters here are indicator, type, country, and at least one of date or daterange(optional in V2 API).
Set country to all to retrieve data for all countries.(Support in Version 1&2 API)

Set region to all to retrieve data for all regions for a specific country. (Support in Version 1&2 API)

Set both country and region to all to retrieve all data. (Not support in Version 2 API. Only available in version 1 API )

Wildcard characters % and _ are enabled for country and region. See Requests section for examples. (Not support in Version 2 API. Only available in version 1 API )

Leave date or daterange blank to retrieve data for all dates for the given geographical areas. (New feature in Version 2 API only.)

If you prefer to use iso_code , gid_0 and gid_1 , you can use our lookup table to convert country names or region names into the geocodes you prefer.

Note: This is no limit for query in Version 2 API (https://covidmap.umd.edu/apiv2/resources). While using the old version 1 API endpoint(https://covidmap.umd.edu/api/resources), the upper limit of returned records of a query is 10000. Users will receive a status message at the end of the JSON data saying, “data truncated when the upper limit is reached.”