{"id":13729566,"url":"https://github.com/dapivei/tweetple","last_synced_at":"2025-05-08T02:30:25.443Z","repository":{"id":62585671,"uuid":"429342222","full_name":"dapivei/tweetple","owner":"dapivei","description":"A wrapper to stream information from Twitter's Full-Archive Search Endpoint. To exploit this library, one must have approved academic research access.","archived":false,"fork":false,"pushed_at":"2022-05-05T02:18:25.000Z","size":39,"stargazers_count":13,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-09T02:11:12.124Z","etag":null,"topics":["academic","twitter"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dapivei.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"license.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-11-18T07:54:01.000Z","updated_at":"2025-03-19T13:25:37.000Z","dependencies_parsed_at":"2022-11-03T22:05:25.592Z","dependency_job_id":null,"html_url":"https://github.com/dapivei/tweetple","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dapivei%2Ftweetple","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dapivei%2Ftweetple/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dapivei%2Ftweetple/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dapivei%2Ftweetple/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dapivei","download_url":"https://codeload.github.com/dapivei/tweetple/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252986511,"owners_count":21836169,"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":["academic","twitter"],"created_at":"2024-08-03T02:01:02.475Z","updated_at":"2025-05-08T02:30:25.165Z","avatar_url":"https://github.com/dapivei.png","language":"Python","funding_links":[],"categories":["Libraries"],"sub_categories":["Python"],"readme":"# TWEETPLE\r\n\r\n[![Twitter API v2 badge](https://img.shields.io/endpoint?url=https%3A%2F%2Ftwbadges.glitch.me%2Fbadges%2Fv2)](https://developer.twitter.com/en/docs/twitter-api/early-access)\r\n\r\n## Installation\r\n\r\nThe easiest way to install the latest version from PyPI is by using pip:\r\n```python\r\npip install tweetple\r\n```\r\n\r\n## Usage\r\n\r\n+ Users, Followers, Liking Users and Retweeted By Lookup\r\n\r\n```python\r\nimport tweetple\r\n\r\nfrom tweetple import TweetPle\r\n\r\n# Bearer token accesible via Twitter Developer Academic Research Track\r\nbearer_token='AAAAAAAA'\r\n\r\n# List of handle ids\r\nids = ['308131814']\r\n\r\n# Retrieve users' information\r\nTweetPle.TweepleStreamer(ids, bearer_token).user_lookup()\r\n\r\n# Retrieve followers' information\r\nTweetPle.TweepleStreamer(ids, bearer_token).followers_lookup()\r\n\r\n# List of tweet ids\r\n\r\nids = ['308131814']\r\n\r\n# Retrieve liking users\r\nTweetPle.TweepleStreamer(ids, bearer_token).likes_lookup()\r\n\r\n# Retrieve retweeting users\r\n\r\nTweetPle.TweepleStreamer(ids, bearer_token).retweet_lookup()\r\n```\r\n\r\n+ Retrieve Tweets\r\n\r\nOne can provide as input a **list** of:\r\n\r\n1. Tweets' ids\r\n\r\n2. Tweeples' handles\r\n\r\n3. Links\r\n\r\n```python\r\nimport tweetple\r\n\r\nfrom tweetple import TweetPle\r\n\r\n# bearer token accesible via Twitter Developer Academic Research Track\r\nbearer_token='AAAAAAAA'\r\n\r\n# list of tweets' ids\r\ntweetl = ['1461090445702881281']\r\nTweetPle.TweetStreamer(tweetl, bearer_token).main()\r\n\r\n# list of tweeplers' handles\r\ntweeplel = ['zorroyanez']\r\nTweetPle.TweetStreamer(tweeplel, bearer_token).main()\r\n\r\n# list of links potentially shared via twitter\r\nlinkl = ['https://lula.com.br/22-vitorias-judiciais-de-lula-inquerito-contra-filhos-e-encerrado-por-falta-de-provas/']\r\nTweetPle.TweetStreamer(linkl, bearer_token).main()\r\n\r\n```\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdapivei%2Ftweetple","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdapivei%2Ftweetple","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdapivei%2Ftweetple/lists"}