{"id":22958192,"url":"https://github.com/akiomik/squawks","last_synced_at":"2025-07-05T18:36:50.110Z","repository":{"id":51416676,"uuid":"520178424","full_name":"akiomik/squawks","owner":"akiomik","description":"A cli tool to get old tweets as csv","archived":false,"fork":false,"pushed_at":"2024-11-26T07:39:33.000Z","size":218,"stargazers_count":5,"open_issues_count":2,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-11-26T08:29:48.829Z","etag":null,"topics":["csv","old-tweets","tweets-extraction","tweets-scraper","twitter"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/akiomik.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["akiomik"],"patreon":null,"open_collective":null,"ko_fi":"akiomik","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2022-08-01T16:10:32.000Z","updated_at":"2024-11-26T07:39:34.000Z","dependencies_parsed_at":"2023-11-06T09:29:23.644Z","dependency_job_id":"4adca5ef-f332-479a-8d7e-fbc789bbd2aa","html_url":"https://github.com/akiomik/squawks","commit_stats":{"total_commits":102,"total_committers":2,"mean_commits":51.0,"dds":0.0490196078431373,"last_synced_commit":"d35bdcb5ba73d2bd09597f03e72d9e69227fe31f"},"previous_names":["akiomik/get-old-tweets"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akiomik%2Fsquawks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akiomik%2Fsquawks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akiomik%2Fsquawks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akiomik%2Fsquawks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/akiomik","download_url":"https://codeload.github.com/akiomik/squawks/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":229737351,"owners_count":18116454,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["csv","old-tweets","tweets-extraction","tweets-scraper","twitter"],"created_at":"2024-12-14T17:37:09.770Z","updated_at":"2024-12-14T17:37:10.549Z","avatar_url":"https://github.com/akiomik.png","language":"Go","funding_links":["https://github.com/sponsors/akiomik","https://ko-fi.com/akiomik"],"categories":[],"sub_categories":[],"readme":"squawks\n==============\n\n[![Go](https://github.com/akiomik/squawks/actions/workflows/go.yml/badge.svg)](https://github.com/akiomik/squawks/actions/workflows/go.yml)\n[![CodeQL](https://github.com/akiomik/squawks/actions/workflows/codeql.yml/badge.svg)](https://github.com/akiomik/squawks/actions/workflows/codeql.yml)\n\nA cli tool to get old tweets on twitter (inspired by [Jefferson-Henrique/GetOldTweets-python](https://github.com/Jefferson-Henrique/GetOldTweets-python)).\n\n- Download your search results to a csv file\n- No authentication required\n- Works out-of-the-box\n\n## Install\n\n- Download the latest release from [the release page](https://github.com/akiomik/squawks/releases/latest). Supported platforms are Windows, macOS and linux.\n- Extract the downloaded `.tar.gz` file.\n\n## Usage\n\n### Search for tweets\n\n```\nUsage:\n  squawks search tweets --out FILENAME [flags]\n\nFlags:\n      --exclude strings     exclude tweets by type of tweet [hashtags|nativeretweets|retweets|replies] (default [])\n      --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 [])\n      --from string         find tweets sent from a certain user\n      --geocode string      find tweets sent from certain coordinates (e.g. 35.6851508,139.7526768,0.1km)\n  -h, --help                help for tweets\n      --include strings     include tweets by type of tweet [hashtags|nativeretweets|retweets|replies] (default [])\n      --lang string         find tweets by a certain language (e.g. en, es, fr)\n      --near string         find tweets nearby a certain location (e.g. tokyo)\n  -o, --out string          output csv filename (required)\n  -q, --query string        query text to search\n      --since string        find tweets since a certain day (e.g. 2014-07-21)\n      --to string           find tweets sent in reply to a certain user\n      --top                 find top tweets\n      --until string        find tweets until a certain day (e.g. 2020-09-06)\n      --url string          find tweets containing a certain url (e.g. www.example.com)\n      --user-agent string   set custom user-agent\n      --within string       find tweets nearby a certain location (e.g. 1km)\n```\n\n## Example\n\nGet tweets by username:\n\n```sh\nsquawks --from 'barackobama' -o out.csv\n```\n\nGet tweets by query search:\n\n```sh\nsquawks -q 'europe refugees' -o out.csv\n```\n\nGet tweets by username and bound dates:\n\n```sh\nsquawks --from 'barackobama' --since 2015-09-10 --until 2015-09-12 -o out.csv\n```\n\nGet top tweets by username:\n\n```sh\nsquawks --from 'barackobama' --top -o out.csv\n```\n\n## Output CSV schema\n\n- `id` (int)\n- `username` (str)\n- `created_at` (datetime)\n- `full_text` (str)\n- `retweet_count` (int)\n- `favorite_count` (int)\n- `reply_count` (int)\n- `quote_count` (int)\n- `latitude` (float)\n- `longitude` (float)\n- `lang` (str)\n- `source` (str)\n\n## Build\n\n```sh\nmake build\n```\n\n## Test\n\n```sh\nmake test\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakiomik%2Fsquawks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fakiomik%2Fsquawks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakiomik%2Fsquawks/lists"}