Open documentation ↗Overview
Use the X API with an all-new Developer Console and consumption-based billing. No fixed monthly costs, no monthly caps.
Twitter API is a social API from twitter.com. It needs no API key. It is served over HTTPS. Its OpenAPI description documents 83 endpoints.
At a glance
- Authentication
- No auth
- HTTPS
- Yes
- CORS
- Unknown
- Category
- Social
- Base URL
https://api.twitter.com/1.1- Version
- 1.1
- Endpoints
- 83
- OpenAPI
- Specification ↗
- Spec updated
- 2021-06-21
Make a first request
Replace the placeholders; the documentation says exactly where credentials go.
curl -X GET "https://api.twitter.com/1.1/account/settings.json" \
-H "Accept: application/json"const response = await fetch("https://api.twitter.com/1.1/account/settings.json", {
method: "GET",
headers: {
"Accept": "application/json",
},
});
const data = await response.json();
console.log(data);import requests
response = requests.request(
"GET",
"https://api.twitter.com/1.1/account/settings.json",
headers={
"Accept": "application/json",
},
timeout=30,
)
print(response.json())Endpoints
| Method | Path | What it does |
|---|---|---|
| GET | /account/settings.json | Returns settings (including |
| POST | /account/settings.json | Updates the |
| POST | /account/update_delivery_device.json | Sets which |
| POST | /account/update_profile.json | Sets values that |
| POST | /account/update_profile_background_image.json | Updates the authenticating user's profile background image. This method can also be used to enable |
| POST | /account/update_profile_colors.json | Sets one or |
| POST | /account/update_profile_image.json | Updates the |
| GET | /application/rate_limit_status.json | Returns the |
| POST | /blocks/create.json | Blocks the specified user from |
| POST | /blocks/destroy.json | Un-blocks the user specified |
| GET | /blocks/ids.json | Returns an array of numeric user |
| GET | /blocks/list.json | Allows one to enable or |
| GET | /direct_messages.json | Returns the 20 most recent |
| POST | /direct_messages/destroy.json | Destroys the direct |
| POST | /direct_messages/new.json | Sends a new direct |
| GET | /direct_messages/sent.json | Returns the 20 most |
| GET | /direct_messages/show.json | Returns a single direct |
| POST | /favorites/create.json | Favorites the status |
| POST | /favorites/destroy.json | Un-favorites the status |
| GET | /favorites/list.json | Returns the 20 most recent |
| GET | /followers/ids.json | Returns a cursored collection |
| GET | /friends/ids.json | Returns a cursored collection of |
| POST | /friendships/create.json | Allows the authenticating |
| POST | /friendships/destroy.json | Allows the |
| GET | /friendships/incoming.json | Returns the |
| GET | /friendships/lookup.json | Returns the relationships |
| GET | /friendships/outgoing.json | Returns a collection of |
| GET | /friendships/show.json | Returns detailed information |
| POST | /friendships/update.json | Allows one to enable or |
| GET | /geo/id/{place_id}.json | Returns all the |
| POST | /geo/places.json | Creates a new place object at the |
| GET | /geo/reverse_geocode.json | Given a latitude and a |
| GET | /geo/search.json | Search for places that can be |
| GET | /geo/similar_places.json | Locates places near the |
| GET | /help/configuration.json | Returns the current |
| GET | /help/languages.json | Returns the list of languages |
| GET | /help/privacy.json | Returns Twitter's Privacy Policy |
| GET | /help/tos.json | Returns the Twitter Terms of Service |
| POST | /lists/create.json | Creates a new list for the |
| POST | /lists/destroy.json | Deletes the specified list. |
| GET | /lists/list.json | Returns all lists the |
| GET | /lists/members.json | Returns the members of the |
| POST | /lists/members/create.json | Add a member to a list. |
| POST | /lists/members/create_all.json | Adds multiple |
| POST | /lists/members/destroy.json | Removes the specified |
| POST | /lists/members/destroy_all.json | Removes multiple |
| GET | /lists/members/show.json | Check if the specified |
| GET | /lists/memberships.json | Returns the lists the |
| GET | /lists/show.json | Returns the specified list. |
| GET | /lists/statuses.json | Returns tweet timeline for |
| GET | /lists/subscribers.json | Returns the subscribers of |
| POST | /lists/subscribers/create.json | Subscribes the |
| POST | /lists/subscribers/destroy.json | Unsubscribes the |
| GET | /lists/subscribers/show.json | Check if the specified |
| GET | /lists/subscriptions.json | Obtain a collection of |
| POST | /lists/update.json | Updates the specified list. The |
| POST | /saved_searches/create.json | Create a new saved |
| POST | /saved_searches/destroy/{id}.json | Destroys a |
| GET | /saved_searches/list.json | Returns the authenticated |
| GET | /saved_searches/show/{id}.json | Returns the |
| GET | /search/tweets.json | Returns a collection of |
| POST | /statuses/destroy/{id}.json | Destroys the status |
| GET | /statuses/home_timeline.json | Returns a collection |
| GET | /statuses/mentions_timeline.json | Returns the 20 |
| GET | /statuses/oembed.json | Returns information allowing |
| POST | /statuses/retweet/{id}.json | Retweets a tweet. |
| GET | /statuses/retweets/{id}.json | Returns up to 100 of |
| GET | /statuses/show/{id}.json | Returns a single status, |
| POST | /statuses/update.json | Updates the authenticating |
| POST | /statuses/update_with_media.json | Updates the |
| GET | /statuses/user_timeline.json | Returns the 20 most |
| GET | /trends/available.json | Returns the locations that |
| GET | /trends/closest.json | Returns the locations that |
| GET | /trends/place.json | Returns the top 10 trending |
| GET | /users/contributees.json | Returns a collection of |
| GET | /users/contributors.json | Returns a collection of |
| GET | /users/lookup.json | Returns fully-hydrated user |
| POST | /users/report_spam.json | The user |
| GET | /users/search.json | Provides a simple, |
| GET | /users/show.json | Returns a variety of information |
| GET | /users/suggestions.json | Access to Twitter's |
| GET | /users/suggestions/{slug}.json | Access the users in |
| GET | /users/suggestions/{slug}/members.json | Access the |
Questions
Does the Twitter API API need an API key?
No. The Twitter API API can be called without an API key or sign-up, which makes it handy for prototypes and front-end demos.
Does the Twitter API API support HTTPS?
Yes, the Twitter API API is served over HTTPS.
How many endpoints does the Twitter API API have?
Its OpenAPI description lists 83 endpoints in version 1.1. All of them are shown on this page.
What are alternatives to the Twitter API API?
Other Social APIs include Blogger, Facebook, Twitter, Pinterest, TikTok.
Similar social APIs
Compare alternatives →Blogger
SocialThe Blogger APIs allows client applications to view and update Blogger content
Facebook Login, Share on FB, Social Plugins, Analytics and more
Read and write Twitter data
The world's catalog of ideas
TikTok
SocialFetches user info and user's video posts on TikTok platform
Telegram Bot
SocialSimplified HTTP version of the MTProto API for bots
Listed from APIs.guru (CC0).