dev·el·op·ers /dɪˈvɛləpərz/

Individuals or organizations 
that are writing code to learn from the public conversation, contribute to it, or to improve the Twitter experience.

Developer terms

Developer Policy

Twitter loves developers. We’re delighted and amazed by the tools and services this community creates by harnessing the power of Twitter data. As part of our commitment to this community, we aim to provide data access that is open and fair for developers, safe for all people on Twitter, and beneficial for the Twitter platform as a whole. To further these goals we’ve crafted the Developer Policy as a clear and comprehensive guide to help people understand our rules and expectations about appropriate API and Twitter data usage.
USING THIS POLICY

We’ve designed the structure of this policy to make it as easy to follow as possible. Please keep information from the following policy sections top of mind as you use the Twitter API and Twitter data:

  1. Set Yourself Up for Success - As you build on the Twitter platform or access Twitter data, you are responsible for using the data and building a service that complies with all Twitter policies. It’s important that you review this Policy, as well as the policies we link to in this document, before you start using Twitter data. The time spent reviewing our policies may save you hours of rework down the road. 
  2. Privacy and User Control are Essential - Protecting and defending the privacy of people on Twitter is built into the core DNA of our company. As such, we prohibit the use of Twitter data in any way that would be inconsistent with our users' reasonable expectations of privacy. By building on the Twitter API or accessing Twitter data, you have a special role to play in safeguarding this commitment, most importantly through respecting user privacy and providing users with transparency and control over how their data is used. 

  3. Follow the Platform Usage Guidelines - Getting approved to access the Twitter API or Twitter data is just the first step. Before using Twitter data, it is essential that you understand what behavior is and is not allowed. Our Platform Usage Guidelines should be your first stop anytime you have questions about the service that you’re building, or plan to build, on the Twitter platform.

 

We’ve provided a lot more detail on what each of these three key sections mean below. Please review them carefully to ensure that your usage of the Twitter API and Twitter data is consistent with our policies. If we believe you are in violation of this Developer Policy (or any other Twitter policy), we may suspend or permanently revoke your access to the Twitter API and Twitter data. If this happens to you, do not apply for or register additional API keys. Instead, contact us via the API Policy Support form

Finally, please note that Twitter may monitor your use of the Twitter API to improve the Twitter Services, to examine any commercial use, and to ensure your compliance with this Policy.

Thanks for reading, and thank you for building with us! We look forward to seeing what you create!

 

 
SET YOURSELF UP FOR SUCCESS

You can avoid many potential pitfalls while using Twitter data by ensuring that your service has been built the right way from Day 1. This section of the Developer Policy contains rules that all developers must follow before using the Twitter API or Twitter data.  

We review all uses of the Twitter developer platform to verify policy compliance — so you’re required to first disclose and update your use case in order to be granted and to maintain access. All new developers must apply for a developer account to access the Twitter API and Twitter data. Current developers without an approved developer account must apply for one as directed to do so by Twitter. As part of this process, you’ll need to provide us with a written description of your intended uses of the Twitter API and Twitter data. 

Your use case description is binding, 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 Twitter data 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

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

You may not register multiple applications for a single use case or substantially similar or overlapping use cases. In this context, a “use case” is a consistent set of analyses, displays, or actions performed via an application. Please note that 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. 

As a single exception to these rules, you may create and use a maximum of 3 applications for development, staging, and production instances of the same service. These apps must be registered to a single user account, and should be clearly identified (in the name and description) as dev, staging, and prod instances of a single service. You may not use development or staging applications for production purposes.

You must keep all API keys or other access credentials private. You may not use, and may not encourage or facilitate others to use, API keys or other access credentials owned by others.  

The Twitter API has rate limits to ensure fair data usage and to help combat spam on the platform. You may not exceed or circumvent these rate limits, nor any other limitations or restrictions described in this Policy, listed on the Developer Site, or communicated to you by Twitter. 

You may not remove or alter any proprietary notices or marks on Twitter content or data received via the Twitter API. This helps to make sure that people know where content is coming from, and who it belongs to. 

For data integrity and platform health reasons you must maintain the features and functionality of the Twitter API, and all Twitter content used on your service. This means that you can’t interfere with, intercept, disrupt, filter, or disable any features of the Twitter API or the Twitter service. This includes content received via embedded Tweets and embedded timelines.

 
PRIVACY AND USER CONTROL ARE KEY

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

Your commitment to privacy must extend to all uses of Twitter data and all aspects of the service that you build using our API. To that end, the people using your service must understand and consent to how you use their data. This can be accomplished through providing users with a clear, comprehensive, and transparent privacy policy, as well as ensuring that you get express and informed consent from each person using your service before taking any action on their behalf. Please note that a user authenticating into your service does not by itself constitute consent

In particular, you must get express and informed consent from people before doing any of the following:

  • Taking any actions on their behalf. This includes (but is not limited to): 

    • Posting content to Twitter

    • Following/unfollowing accounts

    • Modifying profile or account information

    • Starting a Periscope Broadcast

    • Adding hashtags or any other content to Tweets

  • Republishing content accessed by means other than via the Twitter API or other Twitter tools

  • Using someone’s Twitter content to promote a commercial product or service, either on a commercial good or as part of an advertisement

  • Storing non-public content such as Direct Messages (DMs), or any other private or confidential information

  • Sharing or publishing protected content, or any other private or confidential information

If your service allows people to post content to Twitter you must do the following before publishing:

  • Show exactly what will be published

  • Make it clear to people using your service what geo information (if any) will be added to the content

If your service allows people to post content to both your service and Twitter, you must do the following before publishing: 

  • Obtain permission to post the content

  • Explain where you will post the content

You must respect the protected and blocked status of all Twitter content. You may not serve content obtained using one user’s authentication token to a different user who is not authorized to view that content.

  • Protected accounts: A protected account’s content is only available to people who have been approved by the owner to follow that account. So, if you run a service that accesses protected accounts, you may only do so to serve such content to the specific people with permission to view that content. 

  • Blocked accounts: People on Twitter are able to block access to their accounts for any reason they choose. Commingling information obtained from user tokens (or any other API-based action) to bypass this choice is not permitted. 

As Direct Messages (DMs) are non-public in nature, services that provide DM features must take extra steps to safeguard user privacy. You may not serve DM content to users who are not authorized to view that content. If your service provides DM functionality you must also:

  • Notify people if you send read receipt events for DMs. You can do this by providing a notice directly in your service, or by displaying read receipts from other participants in a conversation. 

  • Get consent before configuring media to be sent in a DM as "shared" (i.e. reusable across multiple DMs). If you do allow media in a DM to be “shared,” you must provide a clear notice that this content will be accessible to anyone with the media’s URL.

If you store Twitter content offline, you must keep it up to date with the current state of that content on Twitter. Specifically, you must delete or modify any content you have if it is deleted or modified on Twitter. This must be done as soon as reasonably possible, or within 24 hours after receiving a request to do so by Twitter or the applicable Twitter user, or as otherwise required by applicable law. This must be done unless otherwise prohibited by law, and only then with the express written permission of Twitter. 

Modified content can take various forms. This includes (but is not limited to): 

  • Content that has been made private or gained protected status

  • Content that has been suspended from the platform

  • Content that has had geotags removed from it

  • Content that has been withheld or removed from Twitter 

We limit the circumstances under which you may match a user on Twitter to information obtained or stored off-Twitter. Off-Twitter matching involves associating Twitter content, including a Twitter username or user ID, with a person, household, device, browser, or other off-Twitter identifier. You may only do this if you have express opt-in consent from the user before making the association. 

In situations in which you don’t have a user’s express, opt-in consent to link their Twitter identity to an off-Twitter identifier, we require that any connection you draw be based only on information that a user would reasonably expect to be used for that purpose. In addition, absent a person’s express opt-in consent you may only attempt to match your records about someone to a Twitter identity based on:

  • Information provided directly to you by the user. Note that records about individuals with whom you have no prior relationship, including data about individuals obtained from third parties, do not meet this standard; and/or

  • Public data. “Public data” in this context refers to:

    • Information about a user which you obtained from a public, generally-available resource (such as a directory of members of a professional association)

    • Information on Twitter about a user which is publicly available, including:

      • Tweets

      • Profile information, including a user’s bio and publicly-stated location

      • Display name and username

You must display your service’s privacy policy to users before they are permitted to download, install, or sign up to your service. It must disclose at least the following information: 

  • The information that you collect from users

  • How you use and share that information (including with Twitter) 

  • How users can contact you with inquiries and requests regarding their information

Your privacy policy must be consistent with all applicable laws, and be no less protective of people than Twitter’s Privacy Policy and the privacy policy of our other services and corporate affiliates. You must cease your access to the Twitter API and the use of all Twitter data if you are unable to comply with your and/or Twitter’s Privacy Policy. 

Use of geo data comes with additional restrictions due to the sensitive nature of this information. If your service adds location information to Tweets or Periscope Broadcasts, you must disclose to the user: 

  • When you add location information

  • Whether you add location information as a geotag or annotations data

  • Whether your location information is listed as a place, or as geographic coordinates

If your application allows people to Tweet with their location you must comply with Twitter’s geo guidelines in full. 

Any use of location data or geographic information on a standalone basis is prohibited. You may not (and may not permit others to) store, aggregate, or cache location data and other geographic information contained in Twitter content, except as part of a Tweet or Periscope Broadcast. For example, you may not separate location data or geographic information out from Tweets to show where individuals have been over time. Heat maps and related tools that show aggregated geo activity (e.g., the number of users in a city using a hashtag) are permitted. 

You may not store Twitter passwords, or request that users provide their Twitter password, account credentials, or developer application information (including consumer key) to you directly. We suggest the use of Sign-in with Twitter as the authentication tool to link your service and people on Twitter.

 
PLATFORM USAGE GUIDELINES 

Have you taken care to review Twitter’s policies and set up your API access the right way? Does your service follow Twitter’s privacy and user control guidelines? If you can answer yes to these two questions, then you are ready to start using Twitter data and the Twitter API. Twitter’s Data Usage Guidelines provide the assistance needed to ensure that your use of Twitter data is compliant from Day 1 throughout the lifecycle of your service. We suggest reviewing these rules on a regular basis to make sure that your integration is operating in a way that is safe and beneficial to people on Twitter and the Twitter platform as a whole. 

The use of the Twitter API and developer products to create spam, or engage in spammy behavior, is prohibited. You should review the Twitter Rules on spam, and ensure that your service does not, and does not enable users to violate our policies.

Services that perform write actions, including posting Tweets, following accounts, or sending Direct Messages, must follow the Automation Rules. In particular, you should: 

  • Always get a user’s explicit consent before sending them automated replies or messages

  • Immediately respect user requests to opt-out of being contacted by you

  • Never perform bulk, aggressive, or spammy actions, including bulk following

  • Never post identical or substantially similar content across multiple accounts

If you’re operating an API-based bot account you must clearly indicate what the account is and who is responsible for it. You should never mislead or confuse people about whether your account is or is not a bot. 

You may not use the Twitter API to measure the availability, performance, functionality, or usage of Twitter for benchmarking, competitive, or commercial purposes. For example, you should never use the Twitter API to:

  • Calculate aggregate Twitter user metrics, such as the total number of active users or accounts

  • Calculate aggregate Periscope metrics, such as total number of broadcast views

  • Calculate aggregate Twitter Tweet metrics, such as the total number of Tweets posted per day, or the number of user engagements or account engagements

  • Measure or analyze spam or security on Twitter, except as permitted in the Twitter Rules

  • Measure or analyze the responsiveness of Twitter

We support research that helps improve conversational health on Twitter. You may use the Twitter API and Twitter data to measure and analyze topics like spam, abuse, or other platform health-related topics for non-commercial research purposes. You may not develop, create, or offer commercial services using the Twitter API or Twitter data that measure, analyze, or attempt to identify behaviors or content which violate Twitter policies without express written permission from Twitter. 

You must maintain the integrity of all Twitter content that you display publicly or to users of your service. If you don’t use Twitter for Websites to display content, then you must use the Twitter API to retrieve the most current version available for display. If displayed content ceases to be available through the Twitter API, then you must remove it from your service as soon as reasonably possible, or within 24 hours after the receipt of a removal request from Twitter, or the applicable Twitter user, or as otherwise required by applicable law.  

There are specific rules you must follow if you display Twitter content offline.  Follow the guidelines for using Tweets in broadcast if you display Tweets offline. Follow the guidelines for using Periscope Broadcasts if you display Periscope Broadcasts offline.

The best place to get Twitter data is directly from Twitter. Consequently, we restrict the redistribution of Twitter content to third parties.  If you provide Twitter content to third parties, including downloadable datasets or via an API, you may only distribute Tweet IDs, Direct Message IDs, and/or User IDs (except as described below). We also grant special permissions to academic researchers sharing Tweet IDs and User IDs for non-commercial research purposes.

In total, you may not distribute more than 1,500,000 Tweet 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 Twitter. In addition, all developers may provide up to 50,000 public Tweets Objects and/or User Objects to each user of 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 Tweet 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 Tweet 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 ticket via the API Policy Support form

Any Twitter content provided to third parties remains subject to this Policy, and those third parties must agree to the Twitter Terms of Service, Privacy Policy, Developer Agreement, and Developer Policy before receiving such downloads. You may not enable any entity to circumvent any other limitations or restrictions on the distribution of Twitter content as contained in this Policy, the Developer Agreement, or any other agreement with Twitter. 

The best place to experience Twitter is on Twitter owned and operated (TOO) products. As such, we discourage developers from building services that replicate Twitter’s core user experience or features.

If you create a service that replicates Twitter’s core user experience or features you will be subject to additional rules beyond what is already included in the Developer Policy. In particular, you must: 

  • Obtain our permission to have more than 100,000 user tokens. You may be subject to additional terms if this request is approved

  • Use the Twitter API for functionalities in your service that are substantially similar to Twitter features 

  • Display a prominent link or button in your service that directs new users to Twitter’s account creation page

If you create a service that replicates Twitter’s core user experience or features you may not do any of the following: 

  • Pay, or offer to pay, third parties for distribution. This includes offering compensation for downloads (other than transactional fees) or other mechanisms of traffic acquisition

  • Arrange for your service to be pre-installed on any other device, promoted as a "zero-rated" service, or marketed as part of a specialized data plan 

  • Use Twitter content or other data collected from users to create or maintain a separate status update, social network, private messaging or live broadcasting database or service 

Paying people to take actions on Twitter results in inauthentic conversations that degrade the health of the platform. As you use the Twitter API you may not sell or receive monetary or virtual compensation for any Twitter or Periscope actions. This includes, but is not limited to, Tweets, follows, unfollows, retweets, likes, comments, and replies.  

You must clearly identify your service so that people can understand its source and purpose. Don’t use names, logos, or URLs that mask your service’s identity and features, or that falsely imply an affiliation with Twitter or third parties. Note that creating applications for the purpose of selling names, or to prevent others from using names, is prohibited. 

You may not use any URL (including shortened URLs) for your service that directs people to:

  • A site that is unrelated to your service

  • A spam or malware site

  • A site that encourages people to violate Twitter policy 

You may only use and display the Twitter name and logo to identify Twitter as the source of Twitter content. You should never use the Twitter name and logo, the Twitter Official Partner Program badge, or any other similar marks or names in a manner that creates a false sense of endorsement, sponsorship, or association with Twitter. The Twitter Brand Resources contain detailed information to help you use the Twitter brand in the right way. 

You may only use the Twitter Verified Account badge and any other enhanced user categorization as it is reported to you by Twitter through the API. This helps people know that the content your service displays is equivalent to that shown on Twitter. 

You are allowed to advertise around Twitter content, although there are restrictions regarding how and where you are allowed to do so. To start, your advertisements can’t resemble or reasonably be confused by users as a Tweet or Periscope Broadcast. Other rules on advertising include: 

  • You may advertise in close proximity to the Twitter timeline or a Periscope Broadcast (e.g., banner ads above or below timeline). But, there must be a clear separation between Twitter content and your advertisements. 

  • You may advertise around and on sites that display Tweets and Periscope Broadcasts. But, you may not place any advertisements within the Twitter timeline or on or within Periscope Broadcasts on your service other than Twitter Ads or advertisements made available through the official Twitter Kit integration with MoPub.  

  • Twitter reserves the right to serve advertising via the Twitter API. If you decide to serve Twitter Ads once we start delivering them via the API, we will share a portion of advertising revenue with you in accordance with the relevant terms and conditions.

  • You may not use Twitter content, or information obtained from the Twitter API, to target users with advertising outside of the Twitter platform. Anywhere. Ever. 


You must contact us if you find that your service will require more than 1 million user tokens. Services that require more than 1 million user tokens may be subject to additional terms regarding Twitter API access.