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:
Version 1 API: (depracated; without indicators added after wave 11)
|indicator||Aggregate data to query|| |
|type||Aggregate data type to use|| |
|country||Country to query aggregates for|| |
|region||Region to query aggregates for||(optional) |
|date||Used to query aggregate data for a specific day||(V2:optional) |
|daterange||Used to query aggregates data within a time range||(optional) |
The mandatory parameters here are
country, and at least one of
daterange(optional in V2 API).
all to retrieve data for all countries.(Support in Version 1&2 API)
all to retrieve data for all regions for a specific country. (Support in Version 1&2 API)
all to retrieve all data. (Not support in Version 2 API. Only available in version 1 API )
_ are enabled for
region. See Requests section for examples. (Not support in Version 2 API. Only available in version 1 API )
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
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.”