Support > X API > Developer policy

Developer policy support

As part of our commitment to this community, we aim to provide X API access that is open and fair for developers, safe for people on X, and beneficial for the X platform as a whole. Here we answer frequently asked questions about the developer policies.


Frequently asked questions about the developer policy

Where can I find the X Developer agreement and policy?

See the Developer Agreement and Developer Policy.

How do I agree to these X Developer terms?

By using the X API, you agree to the X Developer Agreement. A review and clickthrough of this agreement is shown during the developer account sign up and apply process.

By building on the X API or accessing X Content, you must comply with ALL X policies. These include this Developer Policy, the Automation Rules, the Display Requirements, the API Restricted Uses Rules, the X Rules, the X Brand Resources, the Periscope Community Guidelines, and the Periscope Trademark Guidelines, as well as any other agreements you enter into with X relating to your use of the X API or X Content, including but not limited to the Developer Agreement or a Master Licensing Agreement or Order (as applicable). You must also comply with any modifications to these policies and any new policies launched by X. It is your responsibility to monitor the use of your service and to design your service to prevent violations of X policy by people who use it. Failure to do so may result in suspension or termination of your API and X Content access.

Where can I ask questions about the Developer Policy or Agreement?

Most questions can be answered by reviewing the Developer Policy, the Automation Rules, the Display Requirements, the API Restricted Uses Rules. If you still have questions, you can contact the policy team using the  API Policy Support form.

Is there a way to be notified when X's developer terms change?

See our stay informed page for notification options.

What will happen if I violate the X developer terms?

X takes privacy seriously, and we expect everyone using X Content and the X API to do the same. Any use of the X developer platform, X API, or X Content in a manner that is inconsistent with peoples’ reasonable expectations of privacy may be subject to enforcement action, which can include suspension and termination of API and X Content access.

If we believe you are in violation of this Policy (or any other X policy), we may suspend or permanently revoke your access to the X API and X Content. If this happens to you, do not apply for or register additional API keys. Instead, contact us via the API Policy Support form.  

Also see our frequently asked questions on App suspension.

How will the X team work with me on policy related issues?

If X identifies a developer's App that is not in compliance with the developer policy, or is operating outside of their approved use case, enforcement actions may be taken on the App.  This could include limiting the Apps ability to make API calls, revoking permissions to the API, or suspending the App or App owner.  You should receive notice of this issue through the X email address of the App owner. 

If your app has been restricted or suspended please do not register an additional app. This is a violation of our terms that may lead to the permanent suspension of your API access. Instead, please file a support ticket via the API Policy Support form under the "My application is suspended or restricted from performing write actions".

When filing this ticket, please include any information you believe may have led to the suspension of your app. Our support team will then work with you to identify this issue, as well as the steps that need to be taken to rectify it. It is always our goal to reactivate the apps of developers who work with us in good faith to resolve policy matters.


Frequently asked questions about access and use cases approval

What does X consider a government entity or a government affiliated entity?

X defines "government use" in the developer agreement. Students at government funded universities are not considered government affiliated.

What is a 'use case' for the X API?

The X API endpoints enable you to manage your posts, publish and curate posts, filter and search for post topics or trends, and much more. Find out more about use cases on our use case page. Your use case should describe your intentions and plan for utilizing the X API with your developer account and your X Apps (applications).

The types of information that are valuable for our review include:

  • The core use case, intent, or business purpose for your use of the X APIs. Please note, “business purpose” in this context includes uses not necessarily connected to a commercial business. We require information about the problem, user story, or the overall goal your use of X content is intended to address.
  • If you are a student, learning to code, or just getting started with the X APIs, please provide details about potential projects, or areas of focus.
  • If you intend to analyze posts, X users, or their content, share details about the analyses you plan to conduct, and the methods or techniques. Note that “analyze” in this context includes any form of processing performed on X content. Please provide as detailed and exhaustive an explanation as possible of your intended use case.
  • If your use involves posting, reposting, or liking content, share how you’ll interact with X accounts, or their content.
  • If you’ll display X content off of X, explain how, and where, posts and X content will be displayed with your product or service, including whether posts and X content will be displayed at row level, or aggregated.

Where possible, please share links to illustrations, or sample work products. 

Your use case description is binding on you, and any substantive deviation from it may constitute a violation of our rules and result in enforcement action. You must notify us of any substantive modification to your use case and receive approval before you may begin using X Content for that new purpose. Failure to do so may result in suspension and termination of your API and data access. You can update your use case by visiting our API Policy Support form, selecting I need to update my developer use case, or as otherwise agreed by X.

Please note that you are not permitted to register multiple applications for a single use case, or substantially similar or overlapping use cases.

In the context of multiple applications, we define “use case” as a consistent set of analyses, displays, or actions performed via an application. Providing the same service or application to different end users (including “white label” versions of a tool or service) counts as a single use case. These rules apply both to applications you register, and to applications registered by the end users of your tool or service; requiring your end users to register applications for the purpose of using your tool or service could result in enforcement actions against you, your applications, your customers, and/or the end users of your tool or service.

The only exception to this rule is to create development (“dev”), staging, and production (“prod”) instances of the same service. Ensure that these applications are clearly labeled (for instance, in the application name or description), and that you do not use development or staging applications for production purposes.

What are some examples of use cases that are not allowed?

Review restricted use cases for the X API. In order to get a comprehensive understanding of what is or is not allowed, you will need to review the Dev Agreement, Dev Policy, the Automation Rules, and the Display Requirements in full, and work with the Policy team to clarify use case approval.

How can I learn more about X's automation rules?

Does X need to approve my use case?

Yes. X will review applications for Enterprise access , as well as applications for specific plans that require further examination.

Can I change my use case?

Use of our developer platform requires that you review and agree to our Developer Agreement and Policy, as well as our related policies, including the Display Requirements and Automation Rules. Among other things, our agreements and policies provide guidance about several restricted use cases. We’ve provided additional information about some of these restrictions below.

Your use case description is binding on you, and any substantive deviation from it may constitute a violation of our rules and result in enforcement action. You must notify us of any substantive modification to your use case and receive approval before you may begin using X Content for that new purpose. Failure to do so may result in suspension and termination of your API and data access. You can update your use case by visiting our API Policy Support form, selecting I need to update my developer use case, or as otherwise agreed by X.

Can post IDs be made publicly available? Can I share post IDs obtained through the X API?

If you provide X Content to third parties, including downloadable datasets or via an API, you may only distribute X IDs, Direct Message IDs, and/or User IDs (except as described below). We also grant special permissions to academic researchers sharing post IDs and User IDs for non-commercial research purposes.

In total, you may not distribute more than 1,500,000 post IDs to any entity (inclusive of multiple individuals associated with a single entity) within any 30 day period unless you have received written permission from X. In addition, all developers may provide up to 50,000 public post Objects and/or User Objects to each person who uses your service on a daily basis if this is done via non-automated means (e.g., download of spreadsheets or PDFs).

Academic researchers are permitted to distribute an unlimited number of post IDs and/or User IDs if they are doing so on behalf of an academic institution and for the sole purpose of non-commercial research. For example, you are permitted to share an unlimited number of post IDs for the purpose of enabling peer review or validation of your research. If you have questions about whether your use case qualifies under this category please submit a request via the API Policy Support form.


Frequently asked questions about X App ownership and permissions

Who should own X Apps that are used in the development of a company's product?

If you are going to be developing with X for your company, then we recommend that you sign up for a team account using your company's X handle. If your company's engineering team uses X Apps for work related to the company that isn’t owned by this company's X handle, we suggest that you transfer those Apps over to the company's account. You can do so by requesting to transfer App ownership. Having all X Projects and Apps owned by the company's X handle will help to prevent any issues in the future in case an engineering resource leaves the company.  If a company's App is owned by an individual employee, and that person leaves the company, it is that person (and not the company) who owns the App. In those situations, the only resource the company has to recover the App is by getting the former employee to agree to transfer access over. X cannot do this without the consent of the App owner (former employee).

How do I transfer ownership of my X App to another account?

You can transfer your X App to another account by selecting 'I need to transfer an API key to another account' when filling out the API Policy Support form.

Should each of my customers set up an App (or X developer account)?

For those planning to make commercial applications, customers of those applications should not make their own developer account and should instead authorize the main commercial app to their X account. Instructing customers of your service to create developer applications that are a copy of your commercial app would be a violation of our developer policy regarding multiple applications with the same use case.

Offering the same service to multiple end users using multiple API applications is not permitted. For example, if your service allows brands to monitor and respond to mentions, you should use a single application for all your end users (who each authenticate with your app using OAuth). Each authenticated user is subject to per-user and per-app API usage limits as applicable. Developers should never request that end users register and provide their own X application consumer keys and secrets to their application in an effort to circumvent this, which may result in enforcement action against both the developer and their users.

Can I have my App’s POST request limit increased to handle multiple X users creating content? 

Please see our forum post announcement on how to request an increase for POST request limits, as well as our blog post on adaptive Direct Messages POST limits.

To request an increase to POST request limits for your App, please request this through the API Policy Support form.

Elevated POST request limit access is generally provided for Apps that need to create a lot of posts. As such, access is normally provided for Apps where multiple X users are creating post content. 

You will always be subject to the overall account limit for a X user of 2,400 posts (including reposts and replies).


Frequently asked questions about X App suspension

Why would a X App get suspended?

If an App is suspended, this means that an enforcement action has been taken on the App. A suspended App is unable to make requests or authenticate new users until the developer takes action and rectifies the matter with X. Developers with suspended Apps will generally receive an email communication (through the App owner's registered X email) at the time of the enforcement action with more details. Here are some reasons your App may get suspended:

  • The app is in violation of one or more of X's developer terms such as our automation rules.

  • The app changed usage that is outside of their specific use case.

  • The app has been dormant for over 365 days.

Suspended Apps are similar to suspended X accounts.

How will I know if my App is suspended?

The X policy team will send a notification to the App owner's X email address if a policy action has been taken on the App.  This email will come from the email address support@twitter.comand will have a subject similar to "Application Suspension Notice".

Within the developer portal, a suspended App will have a red label to show that the App is suspended. API requests made by a suspended App will result in an error similar to:

{"errors": [{"code": 32,"message": "Could not authenticate you."}]}

Can an App be unsuspended?

To appeal, reach out to us through API Policy Support form.

How can I learn more about X's automation rules?


Get support

To get support from X: Please fill out this form to get Policy support in the following scenarios:  

  • My App has been suspended or restricted from performing write actions

  • I need to transfer an API key to another account

  • I need to report an API policy violation

  • I would like to create more than ten Apps

  • I need to update my developer use case

  • Other policy-related matters, not covered by the above

To join community discussions: The X community forum is available for you discuss questions about the X developer platform. You can probably find an answer to your question in the Rules and Policy section of the X community forum. There, you can browse existing topics and learn from others. 

We encourage you to join the conversation by responding to questions and engaging in conversations on our forum. X employees are also there to moderate.

Before you post a question

When you post a question, make sure to include the following information

  • A description of the problem
  • The API call being made (include headers, if possible)
  • The X response returned (include any error messages)
  • What you expected to receive instead
  • List of steps taken to troubleshoot the issue
  • List of steps required to reproduce the issue
  • If relevant, the time frame during which an issue occurred 
  • If relevant, the App ID, post ID, etc.
  • Any relevant code sample or screenshots

Please only include one topic/question per post. 

If you have feature requests or feedback, please submit these through the X Developer Platform Feedback Form

For Policy-related issues, such as App suspension, please contact Policy support.

For X-related issues, such as login and account support, please use the X Help Desk.