Projects

What exactly is a Project? 

A Project allows you to access the new Twitter API products and endpoints. Projects can help you organize your work and access to the Twitter API around a use case. While the concept of a Project is still quite simple, we plan on adding more features and options to make it easier for you to work with the Twitter API.

How many Projects can I create? 

Currently, you’re allowed to have one Project, with one App per Project. We may expand the number of Projects you can create as we launch more products and features.

Other resources I’ve seen don’t reference the concept of Projects. Why might this be? 

We started rolling out Projects to new developers in early 2020 and have since rolled them out to all existing developers as part of the new developer portal. Projects are a new concept to help you organize your work and access to the Twitter API. 

Can I add existing Apps to a Project?

Yes, you can add an existing App to your new Project. While setting up your Project you should see an option to add any of your standalone Apps. 

Is there a way to check usage information towards the cap of 500,000 Tweets per month?

There is a Tweet cap of 500,000 Tweets per month across the following v2 endpoints in Basic access: filtered stream, and recent search. This cap is applied at the Project level. You can check your usage towards the cap by viewing the main dashboard page

Is 500,000 Tweets per month a hard limit? Is there a way to get more?

The 500,000 Tweet cap is for the Basic access level. In future releases, we will be launching elevated access options for the v2 API, with different options for academic researchers, businesses, and other types of developers. Learn how to stay informed of our plans and launches.

Can anyone else see my Project name or information other than me?

Your Project name and description will only be visible to you or your team if you have a team account. It is important to note that if you implement third-party authentication (sometimes referenced as “sign in with Twitter”), your App’s description will be displayed publicly. You should review and update this description before implementing this feature. Be sure to check out our documentation on the subject to learn more.

Why can't I edit a Project?

If your developer account was set up as a team account, you will not be able to edit a Project unless you are an administrator of the account. 

Why can I see an App in a Project, but none of its details? 

If you are on a team, you may view the details of, edit, or manage keys for someone else's App in a team account's Project due to privacy reasons. In this case, you will only be able to see the App name and owner’s name so that you can contact them.

If I had a Project in my account prior to the launch of v2, how do I obtain access to the newest versions of endpoints?

If you have more than one Project created as part of the developer portal beta experience, you will be able to choose which Project will get v2 access in the dashboard section of the portal. 

Where are my keys and tokens? 

You can access your keys and tokens inside of the Projects & Apps section, by clicking on an App. It is important to note, in January 2020, we stopped showing your keys and tokens in your Twitter developer App dashboard beyond the first time that these credentials were generated. You will need to store your keys and tokens securely. If you lost your tokens, or believe that they have been compromised, you will always have the ability to regenerate your keys and tokens via the App dashboard. Note that regenerating your keys and tokens will invalidate any previous keys and tokens and you may need to rewrite and/or redeploy existing code.

 

Was this document helpful?

Thank you

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?

Thank you for the feedback. Your comments will help us improve our documents in the future.