Difference between revisions of "COVID-19 Digital Observatory"

From CommunityData
Line 28: Line 28:
 
The SERP data in our initial data release includes the first search result page from Google and Bing for a variety of COVID-19 related terms gathered from Google Trends and Google and Bing's autocomplete "search suggestions." Specifically, using a set of six "stem keywords" about COVID-19 and online communities ("coronavirus", "coronavirus reddit", coronavirus wiki", "covid 19", "covid 19 reddit", and "covid 19 wiki"), we collect related keywords from Google Trends (using open source software[https://www.npmjs.com/package/google-trends-api]) and autcomplete suggestions from Google and Bing (using open source software[https://github.com/gitronald/suggests]). In addition to COVID 19 keywords, we also collect SERP data for the top daily trending queries, pulled from the Google Trends API.
 
The SERP data in our initial data release includes the first search result page from Google and Bing for a variety of COVID-19 related terms gathered from Google Trends and Google and Bing's autocomplete "search suggestions." Specifically, using a set of six "stem keywords" about COVID-19 and online communities ("coronavirus", "coronavirus reddit", coronavirus wiki", "covid 19", "covid 19 reddit", and "covid 19 wiki"), we collect related keywords from Google Trends (using open source software[https://www.npmjs.com/package/google-trends-api]) and autcomplete suggestions from Google and Bing (using open source software[https://github.com/gitronald/suggests]). In addition to COVID 19 keywords, we also collect SERP data for the top daily trending queries, pulled from the Google Trends API.
  
The SERP data is released as a series of compressed archives (7z), one archive per day, that follow the naming convention <code>covid_search_data-[YYYYMMDD].7z</code>. Within these compressed archives, there is a folder for each device emulated in the data collection (currently two: Chrome on Windows and iPhone X) which contains all of the respective SERP data. Per each device subdirectory, SERP data itself is organized into folders that are titled by the URL of the search query (e.g. <code>'https---www.google.com-search?q=Krispy Kreme'</code>), and each SERP folder contains three data files: a PNG screenshot of the full first page of results, an mhtml "snapshot" (https://github.com/puppeteer/puppeteer/issues/3658), and a json file with a variety of metadata (e.g. date, the device emulated) and a list of every link (<a>) element in the page with its coordinates (top, left, bottom, right) in pixels.
+
The SERP data is released as a series of compressed archives (7z), one archive per day, that follow the naming convention <code>covid_search_data-[YYYYMMDD].7z</code>. Within these compressed archives, there is a folder for each device emulated in the data collection (currently two: Chrome on Windows and iPhone X) which contains all of the respective SERP data. Per each device subdirectory, SERP data itself is organized into folders that are titled by the URL of the search query (e.g. <code>'https---www.google.com-search?q=Krispy Kreme'</code>), and each SERP folder contains three data files:  
 +
* a PNG screenshot of the full first page of results,  
 +
* an mhtml "snapshot" (https://github.com/puppeteer/puppeteer/issues/3658),  
 +
* and a json file with a variety of metadata (e.g. date, the device emulated) and a list of every link (<a>) element in the page with its coordinates (top, left, bottom, right) in pixels.
  
 
===Wikipedia article pages and edit history===
 
===Wikipedia article pages and edit history===

Revision as of 22:45, 29 March 2020

Cmbox notice.png This project page is currently under construction.
Microscopy image of the virus which causes COVID-19.

This page documents a digital observatory project that aims to collect, aggregate, distribute, and document public social data from digital communication platforms in relation to the 2019–20 coronavirus pandemic . The project is being coordinated by the Community Data Science Collective and Pushshift.

Overview and objectives

As people struggle to make sense of the COVID-19 pandemic, many of us turn to social media and social computing systems to share information, to understand what's happening, and to find new ways to support one another. We are building a digital observatory to understand where and how people are talking about COVID-19-related topics. The observatory collects, aggregates, and distributes social data related to how people are responding to the ongoing public health crisis of COVID-19. The public datasets and freely licensed tools, techniques, and knowledge created through this project will allow researchers, practitioners, and public health officials to more efficiently gather, analyze, understand, and act to improve these crucial sources of information during crises.

Everything here is a work in progress as we get the project running, create communication channels, and start releasing datasets. Learn how you can stay connected, use our resources as we produce them, and get involved below.

Stay connected

Subscribe to our low traffic announcement mailing list. You can fill out the form on the list website or email covid19-announce-request@communitydata.science with the word 'help' in the subject or body (don't include the quotes). You will get back a message with instructions.

The email list will contain occasional updates, information about new datasets, partnerships, and so on.

Access Data

(coming soon)

Our initial data releases from this project provide a good starting point for investigating social computing and social media content related COVID-19. At first, we will focus on providing static datasets (in raw text / structured formats like csv and JSON) from Wikipedia and related Wikimedia projects as well as search engine results pages (SERPs) for a set of searches on COVID-19 relevant terms. Over time, we plan to include more sources of data (including international/non-English information), localized content specific to particular geographic regions, additional social media and social computing data sources, and searches from more keywords, all delivered more quickly.

In general, the best way to find the data is to look through our Github repository. If you're familiar with git and github, you can clone the repository and that will get you started. For each data source (e.g., SERPs, Wikipedia pageviews, etc.), you should be able to find a data directory and can download files through the Github web interface or your favorite analysis software. We are also working on providing short example analysis scripts that walk through downloading data directly into something like R and producing some minimal analysis to help you get started.

Search Engine Results Pages (SERP) Data

The SERP data in our initial data release includes the first search result page from Google and Bing for a variety of COVID-19 related terms gathered from Google Trends and Google and Bing's autocomplete "search suggestions." Specifically, using a set of six "stem keywords" about COVID-19 and online communities ("coronavirus", "coronavirus reddit", coronavirus wiki", "covid 19", "covid 19 reddit", and "covid 19 wiki"), we collect related keywords from Google Trends (using open source software[1]) and autcomplete suggestions from Google and Bing (using open source software[2]). In addition to COVID 19 keywords, we also collect SERP data for the top daily trending queries, pulled from the Google Trends API.

The SERP data is released as a series of compressed archives (7z), one archive per day, that follow the naming convention covid_search_data-[YYYYMMDD].7z. Within these compressed archives, there is a folder for each device emulated in the data collection (currently two: Chrome on Windows and iPhone X) which contains all of the respective SERP data. Per each device subdirectory, SERP data itself is organized into folders that are titled by the URL of the search query (e.g. 'https---www.google.com-search?q=Krispy Kreme'), and each SERP folder contains three data files:

  • a PNG screenshot of the full first page of results,
  • an mhtml "snapshot" (https://github.com/puppeteer/puppeteer/issues/3658),
  • and a json file with a variety of metadata (e.g. date, the device emulated) and a list of every link (<a>) element in the page with its coordinates (top, left, bottom, right) in pixels.

Wikipedia article pages and edit history

Our initial release provides exhaustive edit data for the list of English Wikipedia articles covered by WikiProject Covid-19.

Wikipedia pageviews

Our initial release provides pageview data for the list of English Wikipedia articles covered by WikiProject Covid-19.

Keywords and search terms

We currently use and provide three different types of keywords and search terms:

  • Article names/topics from Wikipedia's WikiProject Covid-19
  • Wikidata entities generated via the "Main items" described by Wikidata's WikiProject COVID-19
  • Top 25 daily trending search terms from Google and Bing.

Get Help Using Data

(more coming soon)

As we develop data collection resources and datasets, we will also provide simple example analysis scripts to demonstrate how you might access, import, and analyze small subsets of the data we produce. For instance, take a look at the "analysis" subdirectory of the wikipedia views section of our Github project.

We plan develop tutorials and demos for the use of the data we release and particularly welcome contributions that help make these resources more easily usable by others. In some cases, the data sources are quite large and might not be suitable for analysis on your personal computer. Wherever possible, we'll try to point you to useful tools to help make this feasible or easier.

Contribute

We are eager for collaborators and committed to working openly.

Code of Conduct

We ask that all contributors adhere to the Contributor Covenant.