Support for Twitter API v2

[Harmon758]

Now that the new Twitter API has been launched, support for it needs to be added in Tweepy.
This is planned to be part of v4.0.

v3.10 will be released first, as the last version to support Python 2.7 (and probably Python 3.5).
My goal is to get v3.10 out before the end of the year and then work on dropping support for Python 2.
v3.10 has been released now, and support for Python 2.7 and 3.5 has been dropped.
Afterwards, This will be the next priority, along with support for asyncio.

Initial support for Twitter API v2 has been added with Tweepy v4.0.
Support for additional endpoints and features have been added with Tweepy v4.1, v4.2, v4.3, v4.4, v4.5, and v4.6.

Support for new endpoints and features will be tracked in new individual issues.

Endpoints to support

Tweets

Filtered stream

• GET /2/tweets/search/stream (86244c1)
• GET /2/tweets/search/stream/rules (86244c1)
• POST /2/tweets/search/stream/rules (86244c1)

Hide replies

• PUT /2/tweets/:id/hidden (Support Twitter API v2 #1535)

Likes (lookup + manage)

• DELETE /2/users/:id/likes/:tweet_id (5beaa24)
• GET /2/tweets/:id/liking_users (a32e6ce)
• GET /2/users/:id/liked_tweets (a32e6ce)
• POST /2/users/:id/likes (5beaa24)

Manage Tweets

• DELETE /2/tweets/:id (7884e3a)
• POST /2/tweets (7884e3a)

Retweets

• DELETE /2/users/:id/retweets/:source_tweet_id (b4985e0)
• GET /2/tweets/:id/retweeted_by (b4985e0)
• POST /2/users/:id/retweets (b4985e0)

Search Tweets (full-archive + recent)

• GET /2/tweets/search/all (Support Twitter API v2 #1535)
• GET /2/tweets/search/recent (Support Twitter API v2 #1535)

Timelines

• GET /2/users/:id/mentions (Support Twitter API v2 #1535)
• GET /2/users/:id/tweets (Support Twitter API v2 #1535)
• GET /2/users/by/username/:username/mentions
• GET /2/users/by/username/:username/tweets

Tweet counts

• GET /2/tweets/counts/all (49156cb)
• GET /2/tweets/counts/recent (49156cb)

Tweet lookup

• GET /2/tweets (Support Twitter API v2 #1535)
• GET /2/tweets/:id (Support Twitter API v2 #1535)

Volume streams

• GET /2/tweets/sample/stream (86244c1)

Users

Blocks (lookup + manage)

• DELETE /2/users/:source_user_id/blocking/:target_user_id (18e0b1a)
• GET /2/users/:id/blocking (a32e6ce)
• POST /2/users/:id/blocking (18e0b1a)

Follows (lookup + manage)

• DELETE /2/users/:source_user_id/following/:target_user_id (Support Twitter API v2 #1535)
• GET /2/users/:id/followers (Support Twitter API v2 #1535)
• GET /2/users/:id/following (Support Twitter API v2 #1535)
• GET /2/users/by/username/:username/followers
• GET /2/users/by/username/:username/following
• POST /2/users/:id/following (Support Twitter API v2 #1535)

Mutes (lookup + manage)

• DELETE /2/users/:source_user_id/muting/:target_user_id (b20b236)
• GET /2/users/:id/muting (00cdab8)
• POST /2/users/:id/muting (b20b236)

User lookup

• GET /2/users (Support Twitter API v2 #1535)
• GET /2/users/:id (Support Twitter API v2 #1535)
• GET /2/users/by (Support Twitter API v2 #1535)
• GET /2/users/by/username/:username (Support Twitter API v2 #1535)
• GET /2/users/me (c49cbdf, 62b5b58)

Spaces

Search Spaces

• GET /2/spaces/search (5c68892)

Spaces lookup (buyers, Tweets)

• GET /2/spaces (5c68892)
• GET /2/spaces/:id (5c68892)
• GET /2/spaces/:id/buyers (8bf58ca)
• GET /2/spaces/:id/tweets (c8d5d9a)
• GET /2/spaces/by/creator_ids (5c68892)

Lists (lookup + manage)

List Tweets lookup

• GET /2/lists/:id/tweets (0aa2366)

List follows

• DELETE /2/users/:id/followed_lists/:list_id (b1342bf)
• GET /2/lists/:id/followers (0aa2366)
• GET /2/users/:id/followed_lists (0aa2366)
• POST /2/users/:id/followed_lists (b1342bf)

List lookup

• GET /2/lists/:id (0aa2366)
• GET /2/users/:id/owned_lists (0aa2366)

List members

• DELETE /2/lists/:id/members/:user_id (b1342bf)
• GET /2/lists/:id/members (0aa2366)
• GET /2/users/:id/list_memberships (0aa2366)
• POST /2/lists/:id/members (b1342bf)

Manage Lists

• DELETE /2/lists/:id (b1342bf)
• PUT /2/lists/:id (b1342bf)
• POST /2/lists (b1342bf)

Pinned Lists

• DELETE /2/users/:id/pinned_lists/:list_id (b1342bf)
• GET /2/users/:id/pinned_lists (0aa2366)
• POST /2/users/:id/pinned_lists (b1342bf)

Compliance

Batch Compliance

• GET /2/compliance/jobs (6ca75e1)
• GET /2/compliance/jobs/:id (6ca75e1)
• POST /2/compliance/jobs (6ca75e1)

Addendum

• Media alt_text field (379e99a)
• state parameter optional for spaces search endpoint (e61d5d6)
• Space ended_at and topic_ids fields (c89a233)
• OAuth 2.0 Authorization Code Flow with Proof Key for Code Exchange (PKCE) (2b83507, 8f38429)
• Updates to Retweets lookup and Likes lookup endpoints (3479e56, bdd6b55)
• sort_order parameter for search endpoints (bd202e5, 8b47170)
• Space subscriber_count field (1ffc8cd)

Support for Labs (https://developer.twitter.com/en/products/labs)

COVID-19 stream (#1790)

• GET /labs/1/tweets/stream/compliance
• GET /labs/1/tweets/stream/covid19

Additional Resources

https://developer.twitter.com/en/docs/twitter-api/early-access
https://developer.twitter.com/en/docs/twitter-api/migrate
https://developer.twitter.com/en/products/twitter-api/early-access/guide
https://blog.twitter.com/developer/en_us/topics/tools/2020/introducing_new_twitter_api.html
https://twittercommunity.com/t/announcing-early-access-to-the-next-generation-of-the-twitter-api/139612

https://twittercommunity.com/t/blocks-and-likes-endpoints-are-now-complete-on-the-twitter-api-v2/154434

https://blog.twitter.com/developer/en_us/topics/tools/2021/shape-the-future-of-twitter-spaces

https://twittercommunity.com/t/announcing-oauth-2-0-beta/159189

Old Postscript

I'd like to apologize for the delay in responding to @andypiper and others about this in #1345, #1396, and #1423, as well as on Discord. I've (I think understandably) fallen behind a bit this year in my plans for Tweepy and in keeping up with issues and Discord messages, but I'm working on catching back up.

[Harmon758]

I've created an initial implementation in an api-v2 branch and PR #1535.

[azharmunir43]

hey @Harmon758 thanks for this, can we get some idea about when is it going to be released? Thanks

[Harmon758]

Most of the endpoints should now be part of the api-v2 branch / PR #1535.
Once that PR is ready, I'll take it out of its draft state and leave it open for a few weeks for people to test and review.
Afterwards, it'll be merged into the master branch.
As for v4.0 itself, there's other features (https://github.com/tweepy/tweepy/milestone/11) that I want to include in it before it's released.

[Harmon758]

The api-v2 branch / pull request #1535 should be complete now.
Any feedback or review would be appreciated.

[Harmon758]

The api-v2 branch / pull request #1535 has been merged into the master branch.

[Harmon758]

Client.like and Client.unlike have been added with 5beaa24.

[Harmon758]

Client.block and Client.unblock have been added with 18e0b1a.

[Harmon758]

Client.get_liking_users, Client.get_liked_tweets, and Client.get_blocked have been added with a32e6ce.

[Harmon758]

Client.get_all_tweets_count and Client.get_recent_tweets_count have been added with 49156cb.

[Harmon758]

Client.unmute and Client.mute have been added with b20b236.

[Harmon758]

Client.unretweet, Client.get_retweeters, and Client.retweet have been added with b4985e0.

[Harmon758]

Client.delete_list, Client.remove_list_member, Client.unfollow_list, Client.unpin_list, Client.update_list Client.create_list, Client.add_list_member, Client.follow_list, and Client.pin_list have been added with b1342bf.

[Harmon758]

v4.2.0 (#1694) has now been released with support for managing lists and the state parameter change for Spaces search 🎉

[Harmon758]

Client.delete_tweet and Client.create_tweet have been added with 7884e3a.

[Harmon758]

v4.3.0 (#1701) has been released with support for the Twitter API v2 manage Tweets endpoints launched today 🎉

[Harmon758]

A List model, Client.get_list_tweets, Client.get_list_followers, Client.get_followed_lists, Client.get_list, Client.get_owned_lists, Client.get_list_members, Client.get_list_memberships, and Client.get_pinned_lists have been added with 0aa2366.

[Harmon758]

Client.get_space_buyers has been added with 8bf58ca.

[Harmon758]

Space.ended_at and Space.topic_ids have been added with c89a233.

[Harmon758]

v4.4.0 (#1705) has been released with support for the new List lookup and Space endpoints, as well as the new Space object fields 🎉

[Harmon758]

Oauth2Handler has been added with 2b83507, and Client.get_me has been added with c49cbdf and 62b5b58.

[Harmon758]

v4.5.0 (#1786) has been released with support for OAuth 2.0 Authorization Code Flow with PKCE and the new authenticated user lookup endpoint 🎉

[Harmon758]

Support for the new max_results and pagination_token parameters for Client.get_retweeters and Client.get_liking_users has been added with 3479e56 and bdd6b55, respectively.

[Harmon758]

Support for the new sort_order parameter for Client.search_all_tweets and Client.search_recent_tweets has been added with bd202e5 and 8b47170, respectively.

[Harmon758]

Client.get_space_tweets has been added with c8d5d9a.

[Harmon758]

Support for streaming, with StreamingClient, StreamResponse, and StreamRule, has been added with 86244c1.

[Harmon758]

Space.subscriber_count has been added with 1ffc8cd.

[Harmon758]

v4.6.0 (#1824) has been released with support for streaming, the new Retweets lookup and Likes lookup endpoint parameters, the new sort_order parameter for search endpoints, and the new Tweets shared in a Space endpoint and RSVP count field for Spaces 🎉

With this release, Tweepy now fully supports all of Twitter API v2, almost exactly a year after the initial implementation for Twitter API v2 support was pushed. New individual issues will be created for any future new Twitter API v2 endpoints and features.

(The COVID-19 stream is the only remaining active portion of Labs and support for it is being tracked in #1790.)