azubiaga/pheme-twitter-conversation-collection

Jan 21, 2016 first commit
	1	The PHEME conversation collection script allows the user to collect the set of tweets replying to a specific tweet, forming a conversation or a thread. The user needs to specify a single source tweet, providing its URL or tweet ID, and the tool collects the replies and stories them in the 'data/tweet-id' directory.
	2
	3	NOTE: Since retrieval of replying tweets has been discontinued in Twitter API v1.1 (it used to be available through the 'related_results/show' endpoint in v1.0), this script scrapes the replies from the HTML of the source tweet.
	4
	5	-----
	6	SETUP
	7	-----
	8
	9	The script is developed using PHP (it was initially intended to run as a web service) and Python (for the back-end to access the Twitter API using the Tweepy library). It is ready to run on a system with PHP installed (i.e., the 'php5-cli' package on UNIX systems, or the equivalent PHP CLI for Windows). However, it does need to define a few settings in order to be able to access Twitter.com and the API. There are basically two steps:
	10
	11	1. Create a cookie file to enable web access to replies:
	12
	13	This can be done using Mozilla Firefox and the add-on Cookies Export/Import, which can be installed from:
	14	https://addons.mozilla.org/en-US/firefox/addon/cookies-exportimport/
	15
	16	It is recommended to delete all existing cookies on Firefox before proceeding. Then, you should log in on Twitter.com with some user account. After logging in, click on 'Tool -> Export cookies', and save the file with the name 'cookies.txt'. This file should be copied into the main directory of this script.
	17
	18	2. Add Twitter API credentials to twitter.ini:
	19
	20	This is the Twitter API configuration file. You will see four lines there where you can specify the Twitter API credentials.
	21
	22	-------------
	23	HOW TO RUN IT
	24	-------------
	25
	26	Once you have the ID of the tweet that you want to get the conversation for, you can run the following command:
	27
	28	php get.thread.php tweet-id
	29
	30	Where tweet-id is the ID of the tweet that you are interested in. If successful, the script will output the number of replies that have been collected, and a new directory will be created in the 'data' folder.
	31
	32	---------
	33	REFERENCE
	34	---------
	35
	36	This conversation collection script was used for the following paper:
	37
	38	Arkaitz Zubiaga, Geraldine Wong Sak Hoi, Maria Liakata, Rob Procter, Peter Tolmie. Analysing How People Orient to and Spread Rumours in Social Media by Looking at Conversational Threads. arXiv. 2015.
	39	# pheme-conversation-collection

1

The PHEME conversation collection script allows the user to collect the set of tweets replying to a specific tweet, forming a conversation or a thread. The user needs to specify a single source tweet, providing its URL or tweet ID, and the tool collects the replies and stories them in the 'data/tweet-id' directory.

2

3

NOTE: Since retrieval of replying tweets has been discontinued in Twitter API v1.1 (it used to be available through the 'related_results/show' endpoint in v1.0), this script scrapes the replies from the HTML of the source tweet.

4

5

-----

6

SETUP

7

-----

8

9

The script is developed using PHP (it was initially intended to run as a web service) and Python (for the back-end to access the Twitter API using the Tweepy library). It is ready to run on a system with PHP installed (i.e., the 'php5-cli' package on UNIX systems, or the equivalent PHP CLI for Windows). However, it does need to define a few settings in order to be able to access Twitter.com and the API. There are basically two steps:

10

11

1. Create a cookie file to enable web access to replies:

12

13

This can be done using Mozilla Firefox and the add-on Cookies Export/Import, which can be installed from:

14

https://addons.mozilla.org/en-US/firefox/addon/cookies-exportimport/

15

16

It is recommended to delete all existing cookies on Firefox before proceeding. Then, you should log in on Twitter.com with some user account. After logging in, click on 'Tool -> Export cookies', and save the file with the name 'cookies.txt'. This file should be copied into the main directory of this script.

17

18

2. Add Twitter API credentials to twitter.ini:

19

20

This is the Twitter API configuration file. You will see four lines there where you can specify the Twitter API credentials.

21

22

-------------

23

HOW TO RUN IT

24

-------------

25

26

Once you have the ID of the tweet that you want to get the conversation for, you can run the following command:

27

28

php get.thread.php tweet-id

29

30

Where tweet-id is the ID of the tweet that you are interested in. If successful, the script will output the number of replies that have been collected, and a new directory will be created in the 'data' folder.

31

32

---------

33

REFERENCE

34

---------

35

36

This conversation collection script was used for the following paper:

37

38

Arkaitz Zubiaga, Geraldine Wong Sak Hoi, Maria Liakata, Rob Procter, Peter Tolmie. Analysing How People Orient to and Spread Rumours in Social Media by Looking at Conversational Threads. arXiv. 2015.

39

# pheme-conversation-collection