API reference index

Basics

• Authentication

  • GET oauth/authenticate
  • GET oauth/authorize
  • POST oauth/access_token
  • POST oauth/invalidate_token
  • POST oauth/request_token
  • POST oauth2/invalidate_token
  • POST oauth2/token

Accounts and users

• Create and manage lists

  • GET lists/list
  • GET lists/members
  • GET lists/members/show
  • GET lists/memberships
  • GET lists/ownerships
  • GET lists/show
  • GET lists/statuses
  • GET lists/subscribers
  • GET lists/subscribers/show
  • GET lists/subscriptions
  • POST lists/create
  • POST lists/destroy
  • POST lists/members/create
  • POST lists/members/create_all
  • POST lists/members/destroy
  • POST lists/members/destroy_all
  • POST lists/subscribers/create
  • POST lists/subscribers/destroy
  • POST lists/update

• Follow, search, and get users

  • GET followers/ids
  • GET followers/list
  • GET friends/ids
  • GET friends/list
  • GET friendships/incoming
  • GET friendships/lookup
  • GET friendships/no_retweets/ids
  • GET friendships/outgoing
  • GET friendships/show
  • GET users/lookup
  • GET users/search
  • GET users/show
  • GET users/suggestions (deprecated)
  • GET users/suggestions/:slug (deprecated)
  • GET users/suggestions/:slug/members (deprecated)
  • POST friendships/create
  • POST friendships/destroy
  • POST friendships/update

• Manage account settings and profile

  • GET account/settings
  • GET account/verify_credentials
  • GET saved_searches/list
  • GET saved_searches/show/:id
  • GET users/profile_banner
  • POST account/remove_profile_banner
  • POST account/settings
  • POST account/update_profile
  • POST account/update_profile_background_image (deprecated)
  • POST account/update_profile_banner
  • POST account/update_profile_image
  • POST saved_searches/create
  • POST saved_searches/destroy/:id

• Mute, block and report users

  • GET blocks/ids
  • GET blocks/list
  • GET mutes/users/ids
  • GET mutes/users/list
  • POST blocks/create
  • POST blocks/destroy
  • POST mutes/users/create
  • POST mutes/users/destroy
  • POST users/report_spam

• Subscribe to account activity

  • Enterprise Account Activity API
  • Premium Account Activity API
  • Replay API

Tweets

• Curate a collection of Tweets

  • GET collections/entries
  • GET collections/list
  • GET collections/show
  • POST collections/create
  • POST collections/destroy
  • POST collections/entries/add
  • POST collections/entries/curate
  • POST collections/entries/move
  • POST collections/entries/remove
  • POST collections/update

• Filter realtime Tweets

  • PowerTrack API
  • PowerTrack Rules API
  • Replay API
  • POST statuses/filter

• Get Tweet timelines

  • GET statuses/home_timeline
  • GET statuses/mentions_timeline
  • GET statuses/user_timeline

• Get batch historical Tweets

  • Historical PowerTrack

• Post, retrieve and engage with Tweets

  • GET favorites/list
  • GET statuses/lookup
  • GET statuses/oembed
  • GET statuses/retweeters/ids
  • GET statuses/retweets/:id
  • GET statuses/retweets_of_me
  • GET statuses/show/:id
  • POST favorites/create
  • POST favorites/destroy
  • POST statuses/destroy/:id
  • POST statuses/retweet/:id
  • POST statuses/unretweet/:id
  • POST statuses/update
  • POST statuses/update_with_media (deprecated)

• Sample realtime Tweets

  • Decahose stream
  • GET statuses/sample

• Search Tweets

  • Enterprise search APIs
  • Premium search APIs
  • Standard search API

• Tweet compliance

  • GET compliance/firehose

Direct Messages

• Buttons

  • Buttons

• Custom profiles

  • DELETE custom_profiles/destroy.json
  • Send a Direct Message with custom profile
  • GET custom_profiles/:id
  • GET custom_profiles/list
  • POST custom_profiles/new.json

• Direct Messages

  • API Reference

• Quick Replies

  • Options Quick Reply

• Sending and receiving events

  • DELETE direct_messages/events/destroy
  • GET direct_messages/events/list
  • GET direct_messages/events/show
  • POST direct_messages/events/new (message_create)

• Typing indicator and read receipts

  • POST direct_messages/indicate_typing
  • POST direct_messages/mark_read

• Welcome Messages

  • DELETE direct_messages/welcome_messages/destroy
  • DELETE direct_messages/welcome_messages/rules/destroy
  • PUT direct_messages/welcome_messages/update
  • GET direct_messages/welcome_messages/list
  • GET direct_messages/welcome_messages/rules/list
  • GET direct_messages/welcome_messages/rules/show
  • GET direct_messages/welcome_messages/show
  • POST direct_messages/welcome_messages/new
  • POST direct_messages/welcome_messages/rules/new

Media

• Upload media

  • GET media/upload (STATUS)
  • POST media/metadata/create
  • POST media/subtitles/create
  • POST media/subtitles/delete
  • POST media/upload
  • POST media/upload (APPEND)
  • POST media/upload (FINALIZE)
  • POST media/upload (INIT)

Trends

• Get locations with trending topics

  • GET trends/available
  • GET trends/closest

• Get trends near a location

  • GET trends/place

Geo

• Get information about a place

  • GET geo/id/:place_id

• Get places near a location

  • GET geo/reverse_geocode
  • GET geo/search

Ads

• Analytics

  • Active Entities
  • Asynchronous Analytics
  • Auction Insights
  • Reach and Average Frequency
  • Synchronous Analytics

• Audiences

  • Audience Intelligence
  • Insights
  • Keyword Insights
  • Tailored Audience Permissions
  • Tailored Audiences
  • Tailored Audiences Users

• Campaign Management

  • Accounts
  • Authenticated User Access
  • Bidding Rules
  • Campaigns
  • Content Categories
  • Features
  • Funding Instruments
  • IAB Categories
  • Line Item Apps
  • Line Item Placements
  • Line Items
  • Media Creatives
  • Promotable Users
  • Promoted Accounts
  • Promoted Tweets
  • Reach Estimate
  • Scheduled Promoted Tweets
  • Targeting Criteria
  • Targeting Options
  • Targeting Suggestions
  • Tax Settings
  • User Settings
  • political-disclaimers

• Creatives

  • Account Media
  • Cards Fetch
  • Draft Tweets
  • Image App Download Cards
  • Image Conversation Cards
  • Image Direct Message Cards
  • Media Library
  • Poll Cards
  • Preroll Call To Actions
  • Scheduled Tweets
  • Tweet Previews
  • Tweets
  • Video App Download Cards
  • Video Conversation Cards
  • Video Direct Message Cards
  • Video Website Cards
  • Website Cards

• General

  • Analytics
  • Audiences
  • Campaign Management
  • Creatives
  • Measurement

• Measurement

  • App Event Provider Configurations
  • App Event Tags
  • App Lists
  • Conversion Attribution
  • Conversion Event
  • Web Event Tags

Metrics

• Get Tweet engagement

  • POST insights/engagement