Skip to content

Authorization OAuth2.0

After Sep 10, 2021, Twitter has released a publicly available beta of our new OAuth 2.0 authorization protocol and fine-grained permission scopes.

If you are interested in shaping the future of OAuth 2.0 on the Twitter Developer Platform, can request access to the OAuth 2.0 beta.


Once you have got the request access for OAuth2.0, your app will have the Client ID to do authorization for OAuth2.0.

You can get more information at the documentation and the community content.

If you're ready, now let's get started do a simple example with this library.

Initial Api

You need Client ID to initial the Api instance.

from pytwitter import Api
api = Api(client_id='your client id', oauth_flow=True)


If your app is belong to Confidential clients. You need also provide Client Secret.

from pytwitter import Api
api = Api(client_id='your client id', client_secret="your client secret", oauth_flow=True)

By default, The callback uri is https://localhost/, You need add this url to App's Authentication settings.

Get authorization url

You need save the code_verifier for generate access token.

authorization_url, code_verifier, state = api.get_oauth2_authorize_url()
# '01wNLFIFeh310NpRLt837gcrvK1JqFrFvoYFU0DnH',
# 'HVLpccax4G57jMJu1yddJtP55HYMQA')

Upon successful authentication, your callback_url would receive a request containing the code parameter.

Eg: https://localhost/?state=HVLpccax4G57jMJu1yddJtP55HYMQA&code=SUVocnRteEF0dFZCMXR0eWQ0aF9HX1ZZMkVmeHhlWTF4NmRMNElPdVNmQ2N4OjE2MzI4NDcode

Generate access token

Once you have the redirect response for your callback url, you can get the user access token.

api.generate_oauth2_access_token(response="response", code_verifier="code_verifier")
# {'token_type':'bearer','expires_in':7200,'access_token':'access_token','scope':'','expires_at':1632852223}

Now the api instance will have the user authorization. You can use this to manage apis need user authorization.