Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/akiomik/squawks
A cli tool to get old tweets as csv
https://github.com/akiomik/squawks
csv old-tweets tweets-extraction tweets-scraper twitter
Last synced: 17 days ago
JSON representation
A cli tool to get old tweets as csv
- Host: GitHub
- URL: https://github.com/akiomik/squawks
- Owner: akiomik
- License: apache-2.0
- Created: 2022-08-01T16:10:32.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-11-26T07:39:33.000Z (about 1 month ago)
- Last Synced: 2024-11-26T08:29:48.829Z (about 1 month ago)
- Topics: csv, old-tweets, tweets-extraction, tweets-scraper, twitter
- Language: Go
- Homepage:
- Size: 213 KB
- Stars: 5
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
squawks
==============
[](https://github.com/akiomik/squawks/actions/workflows/go.yml)
[](https://github.com/akiomik/squawks/actions/workflows/codeql.yml)
A cli tool to get old tweets on twitter (inspired by [Jefferson-Henrique/GetOldTweets-python](https://github.com/Jefferson-Henrique/GetOldTweets-python)).
- Download your search results to a csv file
- No authentication required
- Works out-of-the-box
## Install
- Download the latest release from [the release page](https://github.com/akiomik/squawks/releases/latest). Supported platforms are Windows, macOS and linux.
- Extract the downloaded `.tar.gz` file.
## Usage
### Search for tweets
```
Usage:
squawks search tweets --out FILENAME [flags]
Flags:
--exclude strings exclude tweets by type of tweet [hashtags|nativeretweets|retweets|replies] (default [])
--filter strings find tweets by type of account or tweet [verified|follows|media|images|twimg|videos|periscope|vine|consumer_video|pro_video|native_video|links|hashtags|nativeretweets|retweets|replies|safe|news] (default [])
--from string find tweets sent from a certain user
--geocode string find tweets sent from certain coordinates (e.g. 35.6851508,139.7526768,0.1km)
-h, --help help for tweets
--include strings include tweets by type of tweet [hashtags|nativeretweets|retweets|replies] (default [])
--lang string find tweets by a certain language (e.g. en, es, fr)
--near string find tweets nearby a certain location (e.g. tokyo)
-o, --out string output csv filename (required)
-q, --query string query text to search
--since string find tweets since a certain day (e.g. 2014-07-21)
--to string find tweets sent in reply to a certain user
--top find top tweets
--until string find tweets until a certain day (e.g. 2020-09-06)
--url string find tweets containing a certain url (e.g. www.example.com)
--user-agent string set custom user-agent
--within string find tweets nearby a certain location (e.g. 1km)
```
## Example
Get tweets by username:
```sh
squawks --from 'barackobama' -o out.csv
```
Get tweets by query search:
```sh
squawks -q 'europe refugees' -o out.csv
```
Get tweets by username and bound dates:
```sh
squawks --from 'barackobama' --since 2015-09-10 --until 2015-09-12 -o out.csv
```
Get top tweets by username:
```sh
squawks --from 'barackobama' --top -o out.csv
```
## Output CSV schema
- `id` (int)
- `username` (str)
- `created_at` (datetime)
- `full_text` (str)
- `retweet_count` (int)
- `favorite_count` (int)
- `reply_count` (int)
- `quote_count` (int)
- `latitude` (float)
- `longitude` (float)
- `lang` (str)
- `source` (str)
## Build
```sh
make build
```
## Test
```sh
make test
```