Twitter API, an HTTP API described by an OpenAPI document.
Every row below was read from the vendor's own OpenAPI document. The summary text is theirs. What this registry adds is that each operation is indexed with its method, path, base URL and auth scheme, so a search for a capability can answer with a call rather than a name, and that the endpoint is probed on a schedule.
Specifications as held by the APIs.guru corpus, whose newest record is 2023-04-21. Operations the vendor has added since are not listed here; the origin links above are the vendor's own current documents.
base URLs: https://api.twitter.com/1.1 https://api.twitter.com
auth: b e a r ,
find it by capability: POST /search {"query":{"text":"..."}} returns these
operations with their invocation detail. Connect any agent client.
Twitter API, an HTTP API described by an OpenAPI document.
| method | path | what the vendor says it does |
|---|---|---|
GET | /account/settings.json | Returns settings (including current trend, geo and sleep time information) for the authenticating user. |
POST | /account/settings.json | Updates the authenticating user's settings. |
POST | /account/update_delivery_device.json | Sets which device Twitter delivers updates to for the authenticating user. Sending none as the device paramete |
POST | /account/update_profile.json | Sets values that users are able to set under the Account tab of their settings page. Only the parameters speci |
POST | /account/update_profile_background_image.json | Updates the authenticating user's profile background image. This method can also be used to enable or disable |
POST | /account/update_profile_colors.json | Sets one or more hex values that control the color scheme of the authenticating user's profile page on twitter |
POST | /account/update_profile_image.json | Updates the authenticating user's profile image. Note that this method expects raw multipart data, not a URL t |
GET | /application/rate_limit_status.json | Returns the current rate limits for methods belonging to the specified resource families. Each 1.1 API resour |
POST | /blocks/create.json | Blocks the specified user from following the authenticating user. In addition the blocked user will not show i |
POST | /blocks/destroy.json | Un-blocks the user specified in the ID parameter for the authenticating user. Returns the un-blocked user in t |
GET | /blocks/ids.json | Returns an array of numeric user ids the authenticating user is blocking. |
GET | /blocks/list.json | Allows one to enable or disable retweets and device notifications from the specified user. |
GET | /direct_messages.json | Returns the 20 most recent direct messages sent to the authenticating user. Includes detailed information abou |
POST | /direct_messages/destroy.json | Destroys the direct message specified in the required ID parameter. The authenticating user must be the recipi |
POST | /direct_messages/new.json | Sends a new direct message to the specified user from the authenticating user. Requires both the user and text |
GET | /direct_messages/sent.json | Returns the 20 most recent direct messages sent by the authenticating user. Includes detailed information abou |
GET | /direct_messages/show.json | Returns a single direct message, specified by an id parameter. Like the /1.1/direct_messages.format request, t |
POST | /favorites/create.json | Favorites the status specified in the ID parameter as the authenticating user. Returns the favorite status whe |
POST | /favorites/destroy.json | Un-favorites the status specified in the ID parameter as the authenticating user. Returns the un-favorited sta |
GET | /favorites/list.json | Returns the 20 most recent Tweets favorited by the authenticating or specified user. |
GET | /followers/ids.json | Returns a cursored collection of user IDs for every user following the specified user. At this time, results |
GET | /friends/ids.json | Returns a cursored collection of user IDs for every user the specified user is following (otherwise known as t |
POST | /friendships/create.json | Allows the authenticating users to follow the user specified in the ID parameter. Returns the befriended user |
POST | /friendships/destroy.json | Allows the authenticating user to unfollow the user specified in the ID parameter. Returns the unfollowed use |
GET | /friendships/incoming.json | Returns the relationships of the authenticating user to the comma-separated list of up to 100 screen_names or |
GET | /friendships/lookup.json | Returns the relationships of the authenticating user to the comma-separated list of up to 100 screen_names or |
GET | /friendships/outgoing.json | Returns a collection of numeric IDs for every protected user for whom the authenticating user has a pending fo |
GET | /friendships/show.json | Returns detailed information about the relationship between two arbitrary users. |
POST | /friendships/update.json | Allows one to enable or disable retweets and device notifications from the specified user. |
GET | /geo/id/{place_id}.json | Returns all the information about a known place.Example Values: df51dec6f4ee2b2c |
POST | /geo/places.json | Creates a new place object at the given latitude and longitude. Before creating a place you need to query GET |
GET | /geo/reverse_geocode.json | Given a latitude and a longitude, searches for up to 20 places that can be used as a place_id when updating a |
GET | /geo/search.json | Search for places that can be attached to a statuses/update. Given a latitude and a longitude pair, an IP addr |
GET | /geo/similar_places.json | Locates places near the given coordinates which are similar in name. Conceptually you would use this method t |
GET | /help/configuration.json | Returns the current configuration used by Twitter including twitter.com slugs which are not usernames, maximum |
GET | /help/languages.json | Returns the list of languages supported by Twitter along with their ISO 639-1 code. The ISO 639-1 code is the |
GET | /help/privacy.json | Returns Twitter's Privacy Policy |
GET | /help/tos.json | Returns the Twitter Terms of Service in the requested format. These are not the same as the Developer Rules of |
POST | /lists/create.json | Creates a new list for the authenticated user. Note that you can't create more than 20 lists per account. |
POST | /lists/destroy.json | Deletes the specified list. The authenticated user must own the list to be able to destroy it. |
and 43 more operation(s) in this specification, all searchable.
specification origin: http://api.apigee.com/v1/consoles/twitter/apidescription?format=wadl
Twitter API v2 available endpoints
| method | path | what the vendor says it does |
|---|---|---|
GET | /2/compliance/jobs | List Compliance Jobs Returns recent Compliance Jobs for a given job type and optional job status Compliance |
POST | /2/compliance/jobs | Create compliance job Creates a compliance for the given job type Compliance |
GET | /2/compliance/jobs/{id} | Get Compliance Job Returns a single Compliance Job by ID Compliance |
POST | /2/dm_conversations | Create a new DM Conversation Creates a new DM Conversation. Direct Messages |
GET | /2/dm_conversations/with/{participant_id}/dm_events | Get DM Events for a DM Conversation Returns DM Events for a DM Conversation Direct Messages |
POST | /2/dm_conversations/with/{participant_id}/messages | Send a new message to a user Creates a new message for a DM Conversation with a participant user by ID Direct |
POST | /2/dm_conversations/{dm_conversation_id}/messages | Send a new message to a DM Conversation Creates a new message for a DM Conversation specified by DM Conversati |
GET | /2/dm_conversations/{id}/dm_events | Get DM Events for a DM Conversation Returns DM Events for a DM Conversation Direct Messages |
GET | /2/dm_events | Get recent DM Events Returns recent DM Events across DM conversations Direct Messages |
POST | /2/lists | Create List Creates a new List. Lists |
GET | /2/lists/{id} | List lookup by List ID. Returns a List. Lists |
PUT | /2/lists/{id} | Update List. Update a List that you own. Lists |
DELETE | /2/lists/{id} | Delete List Delete a List that you own. Lists |
GET | /2/lists/{id}/followers | Returns User objects that follow a List by the provided List ID Returns a list of Users that follow a List by |
GET | /2/lists/{id}/members | Returns User objects that are members of a List by the provided List ID. Returns a list of Users that are memb |
POST | /2/lists/{id}/members | Add a List member Causes a User to become a member of a List. Lists |
DELETE | /2/lists/{id}/members/{user_id} | Remove a List member Causes a User to be removed from the members of a List. Lists |
GET | /2/lists/{id}/tweets | List Tweets timeline by List ID. Returns a list of Tweets associated with the provided List ID. Tweets |
GET | /2/openapi.json | Returns the OpenAPI Specification document. Full OpenAPI Specification in JSON format. (See https://github.com |
GET | /2/spaces | Space lookup up Space IDs Returns a variety of information about the Spaces specified by the requested IDs Spa |
GET | /2/spaces/by/creator_ids | Space lookup by their creators Returns a variety of information about the Spaces created by the provided User |
GET | /2/spaces/search | Search for Spaces Returns Spaces that match the provided query. Spaces |
GET | /2/spaces/{id} | Space lookup by Space ID Returns a variety of information about the Space specified by the requested ID Spaces |
GET | /2/spaces/{id}/buyers | Retrieve the list of Users who purchased a ticket to the given space Retrieves the list of Users who purchased |
GET | /2/spaces/{id}/tweets | Retrieve Tweets from a Space. Retrieves Tweets shared in the specified Space. Spaces Tweets |
GET | /2/tweets | Tweet lookup by Tweet IDs Returns a variety of information about the Tweet specified by the requested ID. Twee |
POST | /2/tweets | Creation of a Tweet Causes the User to create a Tweet under the authorized account. Tweets |
GET | /2/tweets/compliance/stream | Tweets Compliance stream Streams 100% of compliance data for Tweets Compliance |
GET | /2/tweets/counts/all | Full archive search counts Returns Tweet Counts that match a search query. Tweets |
GET | /2/tweets/counts/recent | Recent search counts Returns Tweet Counts from the last 7 days that match a search query. Tweets |
GET | /2/tweets/firehose/stream | Firehose stream Streams 100% of public Tweets. Tweets |
GET | /2/tweets/label/stream | Tweets Label stream Streams 100% of labeling events applied to Tweets Compliance |
GET | /2/tweets/sample/stream | Sample stream Streams a deterministic 1% of public Tweets. Tweets |
GET | /2/tweets/sample10/stream | Sample 10% stream Streams a deterministic 10% of public Tweets. Tweets |
GET | /2/tweets/search/all | Full-archive search Returns Tweets that match a search query. Tweets |
GET | /2/tweets/search/recent | Recent search Returns Tweets from the last 7 days that match a search query. Tweets |
GET | /2/tweets/search/stream | Filtered stream Streams Tweets matching the stream's active rule set. Tweets |
GET | /2/tweets/search/stream/rules | Rules lookup Returns rules from a User's active rule set. Users can fetch all of their rules or a subset, spec |
POST | /2/tweets/search/stream/rules | Add/Delete rules Add or delete rules from a User's active rule set. Users can provide unique, optionally tagge |
GET | /2/tweets/{id} | Tweet lookup by Tweet ID Returns a variety of information about the Tweet specified by the requested ID. Tweet |
and 40 more operation(s) in this specification, all searchable.
specification origin: https://api.twitter.com/2/openapi.json
nothing on this page is a rating, an endorsement or a claim about quality. Reachability is what our probes observed from one network; answering is a floor under usefulness, not a measure of it.