Error 401, "unauthorized" while trying to connect to Twitter's API v2 with Academic access

Hello everyone,

I know this is probably a silly question, and that the answer is surely out there, but I have looked at many tutorials and guides on the Twitter Dev platforms, Youtube as well as threads here in this forum, but couldn’t find an answer I managed to understand as the solution I need. I am kind of a newbie with APIs and Postman, and surely do not yet have the technical knowledge allowing me to understand the subtleties linked to my issues.

Here is the situation. I have access to the relatively new Twitter Academic Research track. I have my project and app created, and consequently I have my own tokens and keys. I am interested in collecting historical tweets containing specific keywords (e.g. #globalwarming, among others) using the full-archive search, yet, every time I try to launch a collection, I get an error 401. I have also tried to simply launch Single tweet lookups, with the same error. Here is what I did to setup my Postman environment:

I have added the Twitter Postman collection I need (i.e. the Twitter API v2) as indicated in the Twitter doc here, and the Twitter API v2 now appears both in my Postman Environments and Collections.

Still following the aforementioned guide, I have also added my tokens and keys in the Twitter API v2 Environment. The keys and tokens I am given thanks to my Twitter app on the Academic track are an API Key, and API Secret Key, a Bearer Token, an Access Token, and an Access Token Secret. Yet, within Postman, the fields I am asked to fill are consumer_key, consumer_secret, access_token, token_secret, bearer_token. Here is my first question then: Do I have to understand that the API Key and API Secret correspond to the Consumer Key and Consumer Secret respectively?

My second question is: despite these different variables, I am unable to start any kind of collection. These are the only steps I took. Still following the guide I mentioned, these should be (as far as I understand at least), the only steps needed regarding the parameters and authorizations, apart from the obvious information you need to provide for the specific collections you need (e.g. query information regarding the ‘#globalwarming’ hashtag I gave as an example).
Am I then missing something else that I have not done or that I did improperly preventing me from starting a collection?.

Thanks in advance for any help you could provide. Again, I am a bit at a loss, not being extremely proficient with these types of tools and programming as a whole, so I apologize in advance if the answers were already provided somewhere else.

Do not hesitate to tell me if you need any additional information or screenshots to help you understand my issue, I will try to be as reactive as possible.


Hey @mitchbuchanon ! First off – there’s no shame here in the Just getting started channel, and there is no such thing as a silly question when you’re asking for help :slight_smile:

First question - At the collection level, in the Authorization tab, I suggest changing the type to Bearer Token, and using the one you’ve been provided.

More thoughts:

Second question - When you say “starting a collection”, what do you mean?

Hello @hannah.neil , and thanks a lot for your answer (I kind of lost hope… ^^)!

I’m trying to quickly answer your question here, but I will definitely check the links you provided as soon as possible, it seems very promising!

To answer your second question, I mean start collecting tweets thanks to Postman. As mentioned previously, my project would involve collecting historical tweets containing specific hashtags (e.g. #globalwarming) and analyzing them and various metadata associated to them. Ideally I would like to go as far as 2010, and analyze the discourse associated to global warming and other environmental questions thanks to the study of the geolocation, the date etc, hence my need for other metadata.

Do you think that it is possible to collect such a corpus thanks to Postman?

Thanks in advance, and do not hesitate to ask for further details if anything is unclear. : )

1 Like

Hi @mitchbuchanon! I see you’re working with my good friend - the Twitter API!

What you’re looking to do should absolutely be possible within Postman! In order to do this, you’ll have to have some custom JavaScript code that continuously calls for older tweets if they’re available. This can be done by capturing the “next token” of a request and using that for ensuing requests.

I wrote in more detail about how to achieve this in this post here. Hope that helps!

Hi @sean.keegan , and thanks for your response!

I’ve looked at the resources you’ve provided, and they’re very interesting, but I still can’t get past that “status 401, unauthorized” issue I mentioned in my original post. Any idea what this is?

Thanks in advance!


Hi @mitchbuchanon ,

Sorry to hear you’re still having trouble! You have the right idea in terms of getting started. A 401 error usually mean there was a problem authenticating your request. From the Twitter docs, they specifically say that “A 401 status code means that there was a problem authenticating your request, such as an invalid consumer key or secret.”

My guess is maybe you either entered in the credentials incorrectly or in the wrong spot. You are correct in matching the environment variable names with what Twitter calls them: “API Key” from Twitter developer dashboard goes with consumer_key environment variable and “API Secret Key” from Twitter developer dashboard goes with the consumer_secret environment variable.

The values for the access_token and token_secret environment variables can be retrieved from the “Access Token and Secret” section of your project/app. See the screen shot for where to get this info.

Once all those are entered, you should be good to start making requests! The last thing to check would be that you have your environment saved AND selected. The red oval should have the “Twitter API v2” environment selected. If the environment is not selected and you go to make a request, it will give you that 401 error.

Lastly - you should actually be able to send a successful request if you ONLY use the bearer token. I just tried and was able to make requests with only my bearer token info entered. I would try both methods of sending a request.

If you’re still struggling to get a request working, perhaps some screenshots or a public workspace may help further debug your issues :slight_smile:

Best of luck!

Thanks a lot, I’ll take a look at all that when I have time (not right now unfortunately), and keep you posted if I have any other issue.

Thanks again!


1 Like

Best of luck @mitchbuchanon! Hope you’re able to get something working :slight_smile: