Background: At the time of this writing, the coronavirus disease (COVID-19) pandemic outbreak has already put tremendous strain on many countries' citizens, resources, and economies around the world. Social distancing measures, travel bans, self-quarantines, and business closures are changing the very fabric of societies worldwide. With people forced out of public spaces, much of the conversation about these phenomena now occurs online on social media platforms like Twitter.
Objective: In this paper, we describe a multilingual COVID-19 Twitter data set that we are making available to the research community via our COVID-19-TweetIDs GitHub repository.
Methods: We started this ongoing data collection on January 28, 2020, leveraging Twitter’s streaming application programming interface (API) and Tweepy to follow certain keywords and accounts that were trending at the time data collection began. We used Twitter’s search API to query for past tweets, resulting in the earliest tweets in our collection dating back to January 21, 2020.
Results: Since the inception of our collection, we have actively maintained and updated our GitHub repository on a weekly basis. We have published over 123 million tweets, with over 60% of the tweets in English. This paper also presents basic statistics that show that Twitter activity responds and reacts to COVID-19-related events.
Conclusions: It is our hope that our contribution will enable the study of online conversation dynamics in the context of a planetary-scale epidemic outbreak of unprecedented proportions and implications. This data set could also help track COVID-19-related misinformation and unverified rumors or enable the understanding of fear and panic—and undoubtedly more.
The first cases of coronavirus disease (officially named COVID-19 by the World Health Organization [WHO] on February 11, 2020) were reported in Wuhan, China, in late December 2019; the first fatalities were reported in early 2020 . The fast-rising infections and death toll led the Chinese government to quarantine the city of Wuhan on January 23, 2020 [ ]. During this period, other countries began reporting their first confirmed cases of the disease, and on January 30, 2020, the WHO announced a Public Health Emergency of International Concern. With more countries reporting cases of the disease, and infections rapidly escalating in some regions of the world, including South Korea, Iran, and Italy, the WHO declared COVID-19 a pandemic [ ]. At the time of this writing, COVID-19 has been reported in 185 countries, leaving governments all over the world scrambling for ways to contain the disease and lessen its adverse consequences to their people's health and economy [ ].
Preventative measures implemented by national, state, and local governments now affect the daily routines of millions of people worldwide . Social distancing, the most widely used of such measures, aims to curtail new infections by reducing physical contact between people [ ]. Social distancing measures have led to the cancellation of sporting events and conferences [ ], closures of schools and colleges [ ], and has forced many businesses to require their employees to work from home [ ]. As more and more social interactions move online, the conversation around COVID-19 has continued to expand, with growing numbers turning to social media for both information and company [ , ]. Platforms such as Twitter have become central to the technological and social infrastructure that allows us to stay connected even during crises.
We describe a Twitter data set about COVID-19-related online conversations that we are sharing with the research community. People all over the world take to Twitter to express opinions and engage in dialogue in a public forum, and, with Twitter’s open application programming interface (API), has proven to be an invaluable resource for studying a wide range of topics. Twitter has long been used by the research community as a means to understand dynamics observable in online social networks, from information dissemination [, ] to the prevalence and influence of bots and misinformation [ , ]. More importantly during the current COVID-19 pandemic, Twitter provides researchers the ability to study the role social media plays in the global health crisis [ - ]. We hope that this data will spur new research about the social dimensions of the pandemic.
We began collecting data in real time from Twitter, with the earliest tweets dating to January 21, 2020, by tracking COVID-19-related keywords and accounts. Here, we describe the data collection methods, document initial data statistics, and provide information about how to obtain and use the data.
We have been actively collecting tweets since January 28, 2020, leveraging Twitter's streaming API  and Tweepy [ ] to follow specific keywords and accounts that were trending at the time. When we started collecting tweets, we also used Twitter's search API [ ] on the same keywords to gather related historical tweets. Thus, the earliest tweets in our collection date back to January 21, 2020. Since then, we have incrementally added keywords and accounts to follow based on the conversations occurring on Twitter at any time. We have collected over 72 million tweets from inception to March 21, 2020, constituting roughly 600 GB of raw data, and are still collecting data to this day.
Our collection relies upon publicly available data and is hence registered as IRB (institutional review board) exempt by the University of Southern California IRB (approved protocol UP-17-00610). We release the data set with the stipulation that those who use it must comply with Twitter’s Terms and Conditions .
Tracked Keywords and Accounts
By continuously monitoring Twitter's trending topics, keywords, and sources associated with COVID-19, we did our best to capture conversations related to the outbreak.
Twitter's streaming API returns any tweet containing the keyword(s) in the text of the tweet, as well as in its metadata; therefore, it is not always necessary to have each permutation of a specific keyword in the tracking list. For example, the keyword “Covid” will return tweets that contain both “Covid19” and “Covid-19.” We list a subset of the keywords and accounts that we are following inand , respectively, along with the date we began tracking them. There are some keywords that overlap due to an included keyword being a substring of another, but we included both for good measure. The keyword choices in the current data set are all in English, so there is a heavy bias toward English tweets and events related to English-speaking countries. Due to the evolving nature of the pandemic and online conversations, these tables will expand as we continue to monitor Twitter for additional keywords and accounts to add to our tracking list.
|1/21/2020||Coronavirus; Corona; CDC; Ncov; Wuhan; Outbreak; China|
|1/22/2020||Koronavirus; Wuhancoronavirus; Wuhanlockdown; N95; Kungflu; Epidemic; Sinophobia|
|3/13/2020||Coronapocalypse; CancelEverything; Coronials; SocialDistancing|
|3/14/2020||Panic buying; DuringMy14DayQuarantine; Panic shopping; InMyQuarantineSurvivalKit|
|3/16/2020||chinese virus; stayhomechallenge; DontBeASpreader; lockdown|
|3/18/2020||shelteringinplace; staysafestayhome; trumppandemic; flatten the curve|
|3/19/2020||PPEshortage; saferathome; stayathome|
|Tracked since||Account name|
|1/22/2020||PneumoniaWuhan; CoronaVirusInfo; V2019N; CDCemergency; CDCgov; WHO; HHSGov; NIAIDNews|
Our data collection will continue uninterrupted for the foreseeable future. As the pandemic continues to run its course, we anticipate that the amount of data will grow significantly. The data set is available on GitHub  and is released in compliance with the Twitter's Terms and Conditions, under which we are unable to publicly release the text of the collected tweets. We are, therefore, releasing the Tweet IDs, which are unique identifiers tied to specific tweets. The Tweet IDs can be used by researchers to query Twitter’s API and obtain the complete tweet object, including tweet content (text, URLs, hashtags, etc) and authors’ metadata. This process to retrieve the full tweet object from Twitter starting from a Tweet ID is referred to as hydration. There are several easy-to-use tools that have been developed for such purposes, including the Hydrator [ ] and Twarc [ ], but one could also directly use Twitter’s API to retrieve the desired data. This data set can also be found on Harvard Dataverse [ ]. displays basic statistics, including collection period and number of tweets in that respective release, for all current releases (as of May 15, 2020).
There are a few known gaps in the data, which are listed in. Due to Twitter API restrictions on free data access, we were unable to recover data from the listed times, as Twitter only provides free access to tweets returned from their streaming API from the past week. To request access, interested researchers will need to agree upon the terms of usage dictated by the chosen license.
All of the Tweet ID files are stored in folders that indicate the year and month the tweet was posted (YEAR-MONTH). The individual Tweet ID files each contain a collection of Tweet IDs, with the file names all beginning with the prefix “coronavirus-tweet-id-” followed by the year, month, date, and hour the tweet was posted (YEAR-MONTH-DATE-HOUR).
We note that if a tweet has been removed from the platform, researchers will not be able to obtain the original Tweet.
|Release version||Release date||Data collection period||Tweets, n|
|v1.0||3/17/2020||3/05/2020 - 3/12/2020||8,919,411|
|v1.1||3/23/2020||1/21/2020 - 3/12/2020||63,616,072|
|v1.2||3/31/2020||1/21/2020 - 3/21/2020||72,403,796|
|v1.3||4/11/2020||1/21/2020 - 4/03/2020||87,209,465|
|v1.4||4/13/2020||1/21/2020 - 4/10/2020||94,671,486|
|v1.5||4/20/2020||1/21/2020 - 4/17/2020||101,771,227|
|v1.6||4/26/2020||1/21/2020 - 4/24/2020||109,013,655|
|v1.7||5/04/2020||1/21/2020 - 5/01/2020||115,929,358|
|v1.8||5/11/2020||1/21/2020 - 5/08/2020||123,113,914|
|2/1/2020||4:00 - 9:00 UTC|
|2/8/2020||6:00 - 7:00 UTC|
|2/22/2020||21:00 - 24:00 UTC|
|2/23/2020||0:00 - 24:00 UTC|
|2/24/2020||0:00 - 4:00 UTC|
|2/25/2020||0:00 - 3:00 UTC|
|3/2/2020||Intermittent internet connectivity issues|
The Most Recent Release (Release v1.8—May 11, 2020)
Our 9th release spans January 21, 2020, through May 8, 2020. The data set available now contains tweets from January 21, 2020 (22:00 UTC), through May 8, 2020 (21:00 UTC), with 123,113,914 tweets. The language breakdown of the tweets can be found in. A subset of the keywords and accounts that were followed during this timeframe can be identified by referencing and . For a full and up-to-date list of the keywords we are tracking, please see the “keywords.txt” file in the GitHub repository (a list of the accounts we are tracking can be found in the “accounts.txt” file) [ ]. Some of the keywords may appear earlier than the initial listed track date in , as we systematically ran the same keywords through Twitter's search API to collect past instances of the keywords shortly after adding the keywords to be tracked in real time.
|Language||ISOa||Tweets (N=123,113,914), n (%)|
aISO: International Organization for Standardization.
General Release Notes
In order to use any Twitter-facing libraries, including hydration software, users must first apply for a Twitter developer account and obtain the necessary authentication tokens .
The GitHub community has also generously contributed scripts to enable researchers to hydrate the Tweet IDs using Twarc .
We present an initial analysis of our collected data set that verifies that Twitter discourse statistics reflect major events at the time, and leverage Business Insider , NBC [ ], and CNN [ ] released timelines to identify these events of interest during the development of the COVID-19 pandemic. In some of these analyses, there is a dip on March 2, 2020—this was due to internet connectivity failures throughout that specific day. Our discussion is based on analysis done on tweets from release v1.2 (January 21, 2020 to March 31, 2020), while the most recent release is v1.8.
We tracked the frequency of COVID-19-related hashtags, specifically those that contain the substrings “wuhan,” “coronavirus,” and “covid” throughout our collection period (). We can see that while hashtags with the substring “coronavirus” consistently remain a more heavily used hashtag in our data set, the hashtag usage spiked on the day the WHO declared COVID-19 a global public health emergency; it also spiked on the day the United States announced the first COVID-19-related death [ ]. We also did not see hashtags referencing “covid” being used until February 11, 2020, when the WHO announced “COVID-19” as the official name for the novel coronavirus disease. The keyword “wuhan” in hashtags experienced consistent usage until late February, then steadily declined, which reflects the decrease in cases in China and the global spread of the virus.
We then examined the percentage of total tweets posted in different languages (). Although English is the most prominent language in our data set, we excluded English from this analysis to better visualize tweet activity in countries that experienced COVID-19 outbreaks earlier in the timeline. In particular, we found that Japanese tweet activity increased steadily after the cruise ship Diamond Princess was quarantined off the coast of Yokohama, Japan, with a peak around the time when passengers began to disembark [ ].
There was also a significant spike in tweets from Italy when the first case related to COVID-19 was reported in Lodi, Italy, and first death was seen in Veneto . We also observed a peak in the percentage of Spanish tweets after the first COVID-19 case in Spain was announced on February 1, 2020 [ ] and a steady increase in the percentage of Spanish tweets after reports of the first COVID-19-related death began to emerge (the death itself occurred on February 13th, but the cause was diagnosed postmortem) [ ].
Verified users on Twitter have been identified by Twitter as accounts of public interest and are verified to be authentic accounts . We observed that the verified accounts, which include news sources and political figures, are the most active when major events occur, as seen in . This is to be expected since influential figures and news sources often weigh in and report on breaking news in real time using Twitter as a platform to amplify their messaging. As the United States also drives much of the discourse on Twitter, it is therefore unsurprising that there is a major spike in activity from verified users when the country experienced its first COVID-19-related death.
There are several limitations to our data set. We collect our data set leveraging Twitter’s free streaming API, which only returns 1% of the total Twitter volume, and the volume of tweets we collected continues to be dependent on our filter endpoint and network connection .
While our data set is a multilingual data set, containing tweets in over 67 languages, the keywords and accounts we have been tracking and continue to track have been mostly English keywords and accounts. Thus, there is a significant bias in favor of English tweets in our data set over tweets in other languages.
Despite these limitations, our data collection gathers over 1 million tweets a day from the 1% of tweets available to us through Twitter’s API, and our data set contains on average 35% non-English tweets. Our collection begins in late January, capturing tweets during many major developments, and we plan on continuing collecting tweets for the foreseeable future.
The authors gratefully acknowledge support from the Defense Advanced Research Projects Agency (DARPA); contract #W911NF-17-C-0094.
EC was responsible for data curation. All authors contributed to the writing of this manuscript.
Conflicts of Interest
- Taylor D. NY Times. 2020. A Timeline of the Coronavirus Pandemic URL: https://www.nytimes.com/article/coronavirus-timeline.html [accessed 2020-04-10]
- World Health Organization. 2020. Rolling updates on a coronavirus disease (COVID-19) URL: https://www.who.int/emergencies/diseases/novel-coronavirus-2019/events-as-they-happen [accessed 2020-04-10]
- Dong E, Du H, Gardner L. An interactive web-based dashboard to track COVID-19 in real time. Lancet Infect Dis 2020 May;20(5):533-534. [CrossRef]
- Wu J, Smith S, Khurana M, Siemaszko C, DeJesus-Banos B. NBC News. 2020. Stay-at-home orders across the country URL: https://www.nbcnews.com/health/health-news/here-are-stay-home-orders-across-country-n1168736 [accessed 2020-05-15]
- Centers for Disease Control and Prevention. 2020. Social Distancing URL: https://www.cdc.gov/coronavirus/2019-ncov/prevent-getting-sick/social-distancing.html [accessed 2020-05-15]
- Hadden J, Casado L. Business Insider. Here are the latest major events that have been canceled or postponed because of the coronavirus outbreak, including the 2020 Tokyo Olympics, Burning Man, and the 74th Annual Tony Awards URL: https://www.businessinsider.com/major-events-cancelled-or-postponed-due-to-the-coronavirus-2020 [accessed 2020-05-15]
- Chavez N, Moshtaghian A. CNN. 2020. 48 states have ordered or recommended that schools don’t reopen this academic year URL: https://www.cnn.com/2020/04/18/us/schools-closed-coronavirus/index.html [accessed 2020-05-15]
- Hadden J, Casado L, Sonnemaker T. Business Insider. 2020. Apple, Google, and Amazon are among the largest global companies who have restricted travel or asked their employees to work remotely as a precaution against the novel coronavirus. Here's the full list URL: https://www.businessinsider.com/companies-asking-employees-to-work-from-home-due-to-coronavirus-2020 [accessed 2020-05-15]
- Abbas A, Eliyana A, Ekowati D, Saud M, Raza A, Wardani R. Data set on coping strategies in the digital age: The role of psychological well-being and social capital among university students in Java Timor, Surabaya, Indonesia. Data Brief 2020 Jun;30:105583 [FREE Full text] [CrossRef] [Medline]
- Fischer S. AXIOS. 2020. Social media use spikes during pandemic URL: https://www.axios.com/social-media-overuse-spikes-in-coronavirus-pandemic-764b384d-a0ee-4787-bd19-7e7297f6d6ec.html [accessed 2020-05-15]
- Lerman K, Ghosh R. Information contagion: An empirical study of the spread of news on digg and twitter social networks. Washington, DC: AAAI Publications; 2010 Presented at: Fourth International AAAI Conference on Weblogs and Social Media; 2010; Washington, DC URL: https://arxiv.org/abs/1003.2664
- Romero D, Meeder B, Kleinberg J. Differences in the Mechanics of Information Diffusion across Topics: Idioms, Political Hashtags, Complex Contagion on Twitter. New York, NY, USA: Association for Computing Machinery; 2011 Presented at: The 20th International Conference on World Wide Web WWW '11; 2011; New York, NY, USA p. 695. [CrossRef]
- Castillo C, Mendoza M, Poblete B. Information Credibility on Twitter. : Association for Computing Machinery; 2011 Presented at: The 20th International Conference on World Wide Web WWW '11; 2011; New York, NY, USA p. 675-684. [CrossRef]
- Ferrara E, Varol O, Davis C, Menczer F, Flammini A. The rise of social bots. Commun ACM 2016 Jun 24;59(7):96-104. [CrossRef]
- Liang H, Fung IC, Tse ZTH, Yin J, Chan C, Pechta LE, et al. How did Ebola information spread on twitter: broadcasting or viral spreading? BMC Public Health 2019 Apr 25;19(1):438 [FREE Full text] [CrossRef] [Medline]
- Chew C, Eysenbach G. Pandemics in the age of Twitter: content analysis of Tweets during the 2009 H1N1 outbreak. PLoS One 2010 Nov 29;5(11):e14118 [FREE Full text] [CrossRef] [Medline]
- Ferrara E. #COVID-19 on Twitter: Bots, Conspiracies, and Social Media Activism (arXiv.09531). arXiv.org 2020 [FREE Full text]
- Park HW, Park S, Chong M. Conversations and Medical News Frames on Twitter: Infodemiological Study on COVID-19 in South Korea. J Med Internet Res 2020 May 05;22(5):e18897 [FREE Full text] [CrossRef] [Medline]
- Abd-Alrazaq A, Alhuwail D, Househ M, Hamdi M, Shah Z. Top Concerns of Tweeters During the COVID-19 Pandemic: Infoveillance Study. J Med Internet Res 2020 Apr 21;22(4):e19016 [FREE Full text] [CrossRef] [Medline]
- Twitter. Consuming streaming data URL: https://developer.twitter.com/en/docs/tutorials/consuming-streaming-data [accessed 2020-04-10]
- Tweepy. URL: https://www.tweepy.org/ [accessed 2020-04-10]
- Twitter. Search Tweets URL: https://developer.twitter.com/en/docs/tweets/search/api-reference/get-search-tweets [accessed 2020-04-10]
- Twitter. 2020. Developer Agreement and Policy URL: https://developer.twitter.com/en/developer-terms/agreement-and-policy [accessed 2020-04-10]
- Chen E, Lerman K, Ferrara E. GitHub. 2020. COVID-19-TweetIDs URL: https://github.com/echen102/COVID-19-TweetIDs [accessed 2020-05-15]
- DocNow. GitHub. 2020. Hydrator URL: https://github.com/DocNow/hydrator [accessed 2020-04-10]
- DocNow. GitHub. 2020. Twarc URL: https://github.com/DocNow/twarc [accessed 2020-04-10]
- Chen E, Lerman K, Ferrara E. COVID-19 TweetIDs. Harvard Dataverse 2020 [FREE Full text] [CrossRef]
- Twitter. 2020. Developers URL: https://developer.twitter.com/en [accessed 2020-04-10]
- Secon H, Woodward A, Mosher D. Business Insider. 2020. A comprehensive timeline of the new coronavirus pandemic, from China's first COVID-19 case to the present URL: https://www.businessinsider.com/coronavirus-pandemic-timeline-history-major-events-2020-3 [accessed 2020-04-10]
- Muccari R, Chow D. NBC News. 2020. Coronavirus timeline: Tracking the critical moments of COVID-19 URL: https://www.nbcnews.com/health/health-news/coronavirus-timeline-tracking-critical-moments-covid-19-n1154341 [accessed 2020-04-10]
- CNN Editorial Research. CNN. 2020. Coronavirus Outbreak Timeline Fast Facts URL: https://www.cnn.com/2020/02/06/health/wuhan-coronavirus-timeline-fast-facts/index.html [accessed 2020-04-10]
- Helsel P, Yamamoto A. NBC News. 10 coronavirus cases confirmed from cruise ship quarantined in Japan URL: https://www.nbcnews.com/news/world/10-coronavirus-cases-confirmed-cruise-ship-quarantined-japan-n1130296 [accessed 2020-04-10]
- McCann A, Popovich N, Wu J. NY Times. 2020. Italy's Virus Shutdown Came Too Late. What Happens Now? URL: https://www.nytimes.com/interactive/2020/04/05/world/europe/italy-coronavirus-lockdown-reopen.html [accessed 2020-04-10]
- Yeung J, George S, Kottasová I. CNN. 2020. February 1 coronavirus news URL: https://www.cnn.com/asia/live-news/coronavirus-outbreak-02-01-20-intl-hnk/h_afcf3a4665521aab11c721c8cc80dd03 [accessed 2020-04-10]
- Allen N, Heinrich M. Reuters. 2020. Spain reports first coronavirus death in Valencia URL: https://www.reuters.com/article/us-health-coronavirus-spain-death/spain-confirms-countrys-first-death-from-coronavirus-health-official-idUSKBN20Q2TG [accessed 2020-04-10]
- Twitter. 2020. About verified accounts URL: https://help.twitter.com/en/managing-your-account/about-twitter-verified-accounts [accessed 2020-04-10]
- Morstatter F, Pfeffer J, Liu H, Carley K. Is the Sample Good Enough? Comparing Data from Twitter's Streaming API with Twitter's Firehose. arXiv.org 2013 [FREE Full text]
|API: application programming interface|
|COVID-19: coronavirus disease|
|IRB: institutional review board|
|WHO: World Health Organization|
Edited by G Eysenbach; submitted 10.04.20; peer-reviewed by A Jonas, E Da Silva, M Saud; comments to author 12.05.20; revised version received 15.05.20; accepted 15.05.20; published 29.05.20Copyright
©Emily Chen, Kristina Lerman, Emilio Ferrara. Originally published in JMIR Public Health and Surveillance (http://publichealth.jmir.org), 29.05.2020.
This is an open-access article distributed under the terms of the Creative Commons Attribution License (https://creativecommons.org/licenses/by/4.0/), which permits unrestricted use, distribution, and reproduction in any medium, provided the original work, first published in JMIR Public Health and Surveillance, is properly cited. The complete bibliographic information, a link to the original publication on http://publichealth.jmir.org, as well as this copyright and license information must be included.