Get started with Twitter’s developer platform
Twitter’s developer platform offers several tools and APIs. Below, you’ll find tips to help you get up and running on each product area.
- Display Twitter content on the web and in your app
- Build an app on Twitter
- Understand Twitter data objects
- Create and manage Twitter Ads
- Use the enterprise APIs
- Questions? See our developer forums
Our publisher tools Twitter for Websites and Twitter Kit make it easy to tell the best stories with Tweets, on the web and in native mobile apps. Use TweetDeck to find and curate content, and bring relevant, even real-time, engaging content to your users. Use our publishing portal to easily get the code to embed Tweets and timelines, or create buttons.
1. Discover & curate Tweets
Open up TweetDeck to start finding and organizing Tweets. You can create searches for trending hashtags or interesting topics, and then filter the results by engagement, location, and users. Read our getting started documentation if you're new to the tool, and dig into advanced features to learn how to wrangle Tweets with lists and collections. TweetDeck can be your Twitter content hub, with many columns of timelines or saved Tweets for use in your products.
2a. Embedding on the web
To embed a Tweet on the web, click the “more” menu (•••) and choose “Embed this Tweet”. You can copy and paste a blob of HTML into your template or content management system. To embed an entire column timeline, click the column settings icon and tap “Share”: “Embed Timeline”. Learn now to customize embedded Tweets or embedded timelines by checking out the documentation.
2b. Displaying in a mobile app
Twitter’s API platform includes numerous endpoints to help you build an app and solution on Twitter. Our basic endpoints are available for free. As your app or solution needs grow, you’ll also find enterprise APIs that include increased levels of access.
Get started with the basic REST and Streaming APIs
Twitter’s basic REST and Streaming APIs enable free access to numerous endpoints. To get started, you must first create an app.
1. Create an app
To use an endpoint, you must create an app and use our OAuth-based authorization system. Visit apps.twitter.com to create one.
2. Start using the endpoints!
Once you’ve setup your account, accessing the endpoint is super simple. Check out the documentation and API reference for additional details about each endpoint. There are many libraries and utilities in different programming languages that can help you to get started.
Have a question? There’s a good chance our community has an answer for you. Visit our developer forums to review topics, ask questions, and learn from others.
The following documentation provide 'data dictionaries' to help you understand the many attributes that make up Twitter Tweets, Users and other objects.
Tweets are the basic atomic building block of all things Twitter. Click here to learn more about the Tweet object and its data fields.
The user object contains public Twitter account metadata and describes the author of the Tweet. Click here to learn more.
The entities object encompasses common Tweet elements such hashtags, urls, mentions, and even polls. Click here to learn more.
Twitter extended entities
The extended entities is the go-to object for working with native Twitter media. Native media includes the types of media you can 'attach' while composing a Tweet. This includes up to four photos, or a single video or single animated GIF. Click here to learn more.
When posting Tweets, users have the option to geotag their Tweet with an exact location or a Twitter Place. User accounts can also have geospatial metadata associated with them. Click here to learn more.
Twitter’s Ads API endpoints provides developers a programmatic way to create and manage Twitter Ads campaigns. In addition, these endpoints provide a means to access features like Audiences, Creatives, Targeting, etc.
1. Apply for Ads API access
2. Setup twurl
twurl is a command-line application that can be used to make authenticated requests to the Ads API. Use twurl in order to confirm access to the Ads API by making a call to any Ads API endpoint. Additional details can be found in the twurl tutorial.
3. Review our Tutorials
4. Check out our SDKs
5. Check out our Community
The developer forums are a great place to ask any questions, report an issue or just tell us what you’re building. If you’re an expert on the Ads API feel free to help out others as well!