Introduction
Projects allow you to organize your work based on how you intend to use the X API so you can effectively manage your access to the API and monitor your usage. Each Project can contain one or multiple Apps depending on your access level (described later on this page). You will use these Apps to generate authentication credentials such as API Keys and Secrets, user Access Tokens, and App Access Token.
While you can use these keys and tokens from any App to access the X API or X Ads API (you must apply for additional access to use the Ads API), you must use keys and tokens from an App associated with a Project to be able to use the X API v2 endpoints.
If you have a developer account, you can view and manage your Projects on the Projects & Apps page within the developer portal. Sign up for an account if you don't have one already.
Projects and X API access levels
At this time, there are 4 different tiers of access that are applied at the Project-level:
- Free
- Basic
- Pro
- Enterprise
To learn more about what each of these access levels provides, please visit the about X API page.
You can only have one Project with either Free, Basic, or Pro.
We will describe a few Project-specific differences here for you:
Free
This access tier is provided to anyone who has signed up for a developer account.
Number of Apps within that Project: 1
Tweet consumption cap: 1,500 Tweets per month
Authentication methods:
Basic
This access tier is provided to anyone who has subscribed for Basic access via the developer portal.
Number of Apps within that Project: 2
Tweet consumption cap: 10,000 Tweets per month
Authentication methods:
Pro
This access tier is provided to anyone who has subscribed for Pro access via the developer portal.
Number of Apps within that Project: 3
Tweet consumption cap: 1 million Tweets per month
Authentication methods:
Enterprise
This access tier is provided to anyone who has applied for Enterprise, been approved by our team, and signed a monthly auto renew contract via X account manager. Apply here.
Number of Apps within that Project: 3+
Tweet consumption cap: 50 million+ Tweets per month
Authentication methods:
Tweet caps and Projects
Tweet consumption caps apply at the Project-level, effectively limiting the volume of Tweets you can retrieve from certain X API v2 endpoints within a given month.
Learn more about Tweet caps.
Configuring Projects
Creating a Project
To create a Project, click on “New Project” in your dashboard or the Projects & Apps page within the developer portal. You’ll only be able to see this option if you haven’t already created a Project. You will be prompted to create a Project name, description, and use case. You will also be asked to create a new App or connect an existing standalone App.
Creating or Connecting an App for your Project
If your Project doesn’t include an App, you can add one by clicking on the Project name in the dashboard. From there, you can either create a new App or select an existing standalone App to connect to your Project. The App is where you can generate the authentication keys and tokens listed at the beginning of this guide.
Editing a Project
To edit a Project, click on the name of your Project from the dashboard or Projects & Apps page within the developer portal. From there you will see the details of your Project and can select “edit” to make changes.
Standalone Apps
Standalone Apps are Apps that exist outside of the Project structure. The authentication credentials associated with these standalone Apps can make successful requests to X's API's standard v1.1, premium v1.1, enterprise, or to the X Ads API. Standalone Apps will fail when trying to make requests to the X API v2 endpoints unless you connect them to a Project.
If you created an App before August 2020, they will be visible in the “Standalone Apps” section of the developer portal under Projects & Apps. You will be limited to ten Apps in total, including those that are connected to your Project.
If you’re part of a team account, you will see the Apps that you own under Standalone Apps. If a teammate owns an App that’s part of a Project, you will be able to see the App’s name and owner’s info, but you will not be able to change its settings, access its keys and tokens, or regenerate its keys and tokens. You should contact the App owner to make any changes to their App.