# Twitter API API

> Twitter API API on Apizie: 83 endpoints (Returns settings (including current trend, geo and sleep time information) for the authenticating user., Updates the authenticating user's settings., Sets which device Twitter delivers updates to for the authenticating user. Sending none as the device…, Sets values that users are able to set under the Account tab of their settings page. Only the parameters…, …) returned as clean JSON through one API key. 83 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/social-media:twitter-legacy/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `social-media:twitter-legacy`
- Category: Social Media
- Status: live
- Source: https://dev.twitter.com
- Page: https://zieapi.vercel.app/api/social-media/twitter-legacy
- OpenAPI: https://zieapi.vercel.app/api/social-media/twitter-legacy/openapi.json



## Endpoints

### Returns settings (including current trend, geo and sleep time information) for the authenticating user.
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/account-settings-get`

| Parameter | Type | Required | Description |
|---|---|---|---|
| trend_location_woeid | string | no | The Yahoo! Where On Earth ID to use as the user's default trend location. Global information is available by using 1 as the WOEID. The… |
| sleep_time_enabled | string | no | When set to true, t or 1, will enable sleep time for the user. Sleep time is the time when push or SMS notifications should not be sent to… |
| start_sleep_time | string | no | The hour that sleep time should begin if it is enabled. The value for this parameter should be provided in ISO8601 format (i.e. 00-23).… |
| end_sleep_time | string | no | The hour that sleep time should end if it is enabled. The value for this parameter should be provided in ISO8601 format (i.e. 00-23). The… |
| time_zone | string | no | The timezone dates and times should be displayed in for the user. The timezone must be one of the Rails TimeZone names. Example Values:… |
| lang | string | no | The language which Twitter should render in for this user. The language must be specified by the appropriate two letter ISO 639-1… |

### Updates the authenticating user's settings.
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/account-settings-post`

| Parameter | Type | Required | Description |
|---|---|---|---|
| trend_location_woeid | string | no | The Yahoo! Where On Earth ID to use as the user's default trend location. Global information is available by using 1 as the WOEID. The… |
| sleep_time_enabled | string | no | When set to true, t or 1, will enable sleep time for the user. Sleep time is the time when push or SMS notifications should not be sent to… |
| start_sleep_time | string | no | The hour that sleep time should begin if it is enabled. The value for this parameter should be provided in ISO8601 format (i.e. 00-23).… |
| end_sleep_time | string | no | The hour that sleep time should end if it is enabled. The value for this parameter should be provided in ISO8601 format (i.e. 00-23). The… |
| time_zone | string | no | The timezone dates and times should be displayed in for the user. The timezone must be one of the Rails TimeZone names. Example Values:… |
| lang | string | no | The language which Twitter should render in for this user. The language must be specified by the appropriate two letter ISO 639-1… |

### Sets which device Twitter delivers updates to for the authenticating user. Sending none as the device…
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/account-update-delivery-device`

| Parameter | Type | Required | Description |
|---|---|---|---|
| device | string | yes | Must be one of: sms, none. Example Values: sms |
| include_entities | string | no | When set to either true, t or 1, each tweet will include a node called "entities,". This node offers a variety of metadata about the tweet… |

### Sets values that users are able to set under the Account tab of their settings page. Only the parameters…
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/account-update-profile`

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | no | Full name associated with the profile. Maximum of 20 characters. Example Values: Marcel Molina |
| url | string | no | URL associated with the profile. Will be prepended with "http://" if not present. Maximum of 100 characters. Example Values:… |
| location | string | no | The city or country describing where the user of the account is located. The contents are not normalized or geocoded in any way. Maximum… |
| description | string | no | A description of the user owning the account. Maximum of 160 characters. Example Values: Flipped my wig at age 22 and it never grew back.… |
| include_entities | string | no | The entities node will not be included when set to false. Example Values: false |
| skip_status | string | no | When set to either true, t or 1 statuses will not be included in the returned user objects. |

### Updates the authenticating user's profile background image. This method can also be used to enable or…
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/accounts-update-profile-background-image`

| Parameter | Type | Required | Description |
|---|---|---|---|
| tile | string | no | Whether or not to tile the background image. If set to true, t or 1 the background image will be displayed tiled. The image will not be… |
| use | string | no | Determines whether to display the profile background image or not. When set to true, t or 1 the background image will be displayed if an… |
| include_entities | string | no | The entities node will not be included when set to false. Example Values: false |
| skip_status | string | no | When set to either true, t or 1 statuses will not be included in the returned user objects. |

### Sets one or more hex values that control the color scheme of the authenticating user's profile page on…
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/accounts-update-profile-colors`

| Parameter | Type | Required | Description |
|---|---|---|---|
| profile_background_color | string | no | Profile background color. Example Values: 3D3D3D |
| profile_link_color | string | no | Profile link color.Example Values: 0000FF |
| profile_sidebar_border_color | string | no | Profile sidebar's border color. Example Values: 0F0F0F |
| profile_sidebar_fill_color | string | no | Profile sidebar's background color. Example Values: 00FF00 |
| profile_text_color | string | no | Profile text color. Example Values: 000000 |
| include_entities | string | no | The entities node will not be included when set to false. Example Values: false |
| skip_status | string | no | When set to either true, t or 1 statuses will not be included in the returned user objects. |

### Updates the authenticating user's profile image. Note that this method expects raw multipart data, not a URL…
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/accounts-update-profile-image`

| Parameter | Type | Required | Description |
|---|---|---|---|
| skip_status | string | no | When set to either true, t or 1 statuses will not be included in the returned user objects. |

### Returns the current rate limits for methods belonging to the specified resource families. Each 1.1 API…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/application-rate-limit-status`

| Parameter | Type | Required | Description |
|---|---|---|---|
| resources | string | no | A comma-separated list of resource families you want to know the current rate limit disposition for. For best performance, only specify… |

### Blocks the specified user from following the authenticating user. In addition the blocked user will not show…
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/blocks-create`

| Parameter | Type | Required | Description |
|---|---|---|---|
| include_entities | string | no | The entities node will not be included when set to false. Example Values: false |
| skip_status | string | no | When set to either true, t or 1 statuses will not be included in the returned user objects. |

### Un-blocks the user specified in the ID parameter for the authenticating user. Returns the un-blocked user in…
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/blocks-destroy`

| Parameter | Type | Required | Description |
|---|---|---|---|
| include_entities | string | no | The entities node will not be included when set to false. Example Values: false |
| skip_status | string | no | When set to either true, t or 1 statuses will not be included in the returned user objects. |

### Returns an array of numeric user ids the authenticating user is blocking.
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/blocks-ids`

| Parameter | Type | Required | Description |
|---|---|---|---|
| stringify_ids | string | no | Many programming environments will not consume our ids due to their size. Provide this option to have ids returned as strings instead.… |
| cursor | string | no | Causes the list of blocked users to be broken into pages of no more than 5000 IDs at a time. The number of IDs returned is not guaranteed… |

### Allows one to enable or disable retweets and device notifications from the specified user.
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/blocks-list`

| Parameter | Type | Required | Description |
|---|---|---|---|
| include_entities | string | no | The entities node will not be included when set to false. Example Values: false |
| skip_status | string | no | When set to either true, t or 1 statuses will not be included in the returned user objects. |
| cursor | string | no | Causes the list of blocked users to be broken into pages of no more than 5000 IDs at a time. The number of IDs returned is not guaranteed… |

### Returns the 20 most recent direct messages sent to the authenticating user. Includes detailed information…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/direct-messages`

| Parameter | Type | Required | Description |
|---|---|---|---|
| count | string | no | Specifies the number of direct messages to try and retrieve, up to a maximum of 200. The value of count is best thought of as a limit to… |
| since_id | string | no | Returns results with an ID greater than (that is, more recent than) the specified ID. There are limits to the number of Tweets which can… |
| max_id | string | no | Returns results with an ID less than (that is, older than) or equal to the specified ID. Example Values: 54321 |
| include_entities | string | no | The entities node will not be included when set to false. Example Values: false |
| page | string | no | Specifies the page of results to retrieve. Example Values: 3 |
| skip_status | string | no | When set to either true, t or 1 statuses will not be included in the returned user objects. |

### Destroys the direct message specified in the required ID parameter. The authenticating user must be the…
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/direct-messages-destroy`

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the direct message to delete. Example Values: 1270516771 |
| include_entities | string | no | The entities node will not be included when set to false. Example Values: false |

### Sends a new direct message to the specified user from the authenticating user. Requires both the user and…
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/direct-messages-new`

| Parameter | Type | Required | Description |
|---|---|---|---|
| text | string | yes | The text of your direct message. Be sure to URL encode as necessary, and keep the message under 140 characters. Example Values: Meet me… |

### Returns the 20 most recent direct messages sent by the authenticating user. Includes detailed information…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/direct-messages-sent`

| Parameter | Type | Required | Description |
|---|---|---|---|
| count | string | no | Specifies the number of direct messages to try and retrieve, up to a maximum of 200. The value of count is best thought of as a limit to… |
| since_id | string | no | Returns results with an ID greater than (that is, more recent than) the specified ID. There are limits to the number of Tweets which can… |
| max_id | string | no | Returns results with an ID less than (that is, older than) or equal to the specified ID. Example Values: 54321 |
| include_entities | string | no | The entities node will not be included when set to false. Example Values: false |
| page | string | no | Specifies the page of results to retrieve. Example Values: 3 |

### Returns a single direct message, specified by an id parameter. Like the /1.1/direct_messages.format request,…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/direct-messages-show`

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the direct message. Example Values: 587424932 |

### Favorites the status specified in the ID parameter as the authenticating user. Returns the favorite status…
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/favorites-create`

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The numerical ID of the desired status. Example Values: 123 |
| include_entities | string | no | The entities node will be omitted when set to false. Example Values: false |

### Un-favorites the status specified in the ID parameter as the authenticating user. Returns the un-favorited…
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/favorites-destroy`

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The numerical ID of the desired status. Example Values: 123 |
| include_entities | string | no | The entities node will be omitted when set to false. Example Values: false |

### Returns the 20 most recent Tweets favorited by the authenticating or specified user.
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/favorites-list`

| Parameter | Type | Required | Description |
|---|---|---|---|
| count | string | no | Specifies the number of records to retrieve. Must be less than or equal to 200. Defaults to 20. Example Values: 5 |
| since_id | string | no | Returns results with an ID greater than (that is, more recent than) the specified ID. There are limits to the number of Tweets which can… |
| max_id | string | no | Returns results with an ID less than (that is, older than) or equal to the specified ID. Example Values: 54321 |
| include_entities | string | no | The entities node will be omitted when set to false. Example Values: false |

### Returns a cursored collection of user IDs for every user following the specified user. At this time, results…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/followers-ids`

| Parameter | Type | Required | Description |
|---|---|---|---|
| stringify_ids | string | no | Many programming environments will not consume our Tweet ids due to their size. Provide this option to have ids returned as strings… |
| cursor | string | no | Causes the list of connections to be broken into pages of no more than 5000 IDs at a time. The number of IDs returned is not guaranteed to… |

### Returns a cursored collection of user IDs for every user the specified user is following (otherwise known as…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/friends-ids`

| Parameter | Type | Required | Description |
|---|---|---|---|
| stringify_ids | string | no | Many programming environments will not consume our Tweet ids due to their size. Provide this option to have ids returned as strings… |
| cursor | string | no | Causes the list of connections to be broken into pages of no more than 5000 IDs at a time. The number of IDs returned is not guaranteed to… |

### Allows the authenticating users to follow the user specified in the ID parameter. Returns the befriended…
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/friendships-create`

| Parameter | Type | Required | Description |
|---|---|---|---|
| follow | string | no | Enable notifications for the target user. Example Values: true |

### Allows the authenticating user to unfollow the user specified in the ID parameter. Returns the unfollowed…
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/friendships-destroy`

### Returns the relationships of the authenticating user to the comma-separated list of up to 100 screen_names…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/friendships-incoming`

| Parameter | Type | Required | Description |
|---|---|---|---|
| stringify_ids | string | no | Many programming environments will not consume our Tweet ids due to their size. Provide this option to have ids returned as strings… |
| cursor | string | no | Causes the list of connections to be broken into pages of no more than 5000 IDs at a time. The number of IDs returned is not guaranteed to… |

### Returns the relationships of the authenticating user to the comma-separated list of up to 100 screen_names…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/friendships-lookup`

### Returns a collection of numeric IDs for every protected user for whom the authenticating user has a pending…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/friendships-outgoing`

| Parameter | Type | Required | Description |
|---|---|---|---|
| stringify_ids | string | no | Many programming environments will not consume our Tweet ids due to their size. Provide this option to have ids returned as strings… |
| cursor | string | no | Causes the list of connections to be broken into pages of no more than 5000 IDs at a time. The number of IDs returned is not guaranteed to… |

### Returns detailed information about the relationship between two arbitrary users.
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/friendships-show`

| Parameter | Type | Required | Description |
|---|---|---|---|
| source_id | string | no | The user_id of the subject user. Example Values: 3191321 |
| source_screen_name | string | no | The screen_name of the subject user. Example Values: raffi |
| target_id | string | yes | The user_id of the target user. Example Values: 20 |
| target_screen_name | string | yes | The screen_name of the target user. Example Values: noradio |

### Allows one to enable or disable retweets and device notifications from the specified user.
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/friendships-update`

| Parameter | Type | Required | Description |
|---|---|---|---|
| device | string | yes | Enable/disable device notifications from the target user. Example Values: true, false |
| retweets | string | yes | Enable/disable retweets from the target user. Example Values: true, false |

### Returns all the information about a known place.Example Values: df51dec6f4ee2b2c
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/geo-place-id`

| Parameter | Type | Required | Description |
|---|---|---|---|
| place_id | string | yes | A place in the world. These IDs can be retrieved from geo/reverse_geocode. Example Values: df51dec6f4ee2b2c |

### Creates a new place object at the given latitude and longitude. Before creating a place you need to query…
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/geo-places`

| Parameter | Type | Required | Description |
|---|---|---|---|
| attribute:street_address | string | no | This parameter searches for places which have this given street address. There are other well-known, and application specific attributes… |
| callback | string | no | If supplied, the response will use the JSONP format with a callback of the given name. |

### Given a latitude and a longitude, searches for up to 20 places that can be used as a place_id when updating…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/geo-reverse-geocode`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lat | string | yes | The latitude to search around. This parameter will be ignored unless it is inside the range -90.0 to +90.0 (North is positive) inclusive.… |
| long | string | yes | The longitude to search around. The valid ranges for longitude is -180.0 to +180.0 (East is positive) inclusive. This parameter will be… |
| accuracy | string | no | A hint on the "region" in which to search. If a number, then this is a radius in meters, but it can also take a string that is suffixed… |
| granularity | string | no | This is the minimal granularity of place types to return and must be one of: poi, neighborhood, city, admin or country. If no granularity… |
| max_results | string | no | A hint as to the number of results to return. This does not guarantee that the number of results returned will equal max_results, but… |
| callback | string | no | If supplied, the response will use the JSONP format with a callback of the given name. |

### Search for places that can be attached to a statuses/update. Given a latitude and a longitude pair, an IP…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/geo-search`

| Parameter | Type | Required | Description |
|---|---|---|---|
| accuracy | string | no | A hint on the "region" in which to search. If a number, then this is a radius in meters, but it can also take a string that is suffixed… |
| granularity | string | no | This is the minimal granularity of place types to return and must be one of: poi, neighborhood, city, admin or country. If no granularity… |
| contained_within | string | no | This is the place_id which you would like to restrict the search results to. Setting this value means only places within the given… |
| attribute:street_address | string | no | This parameter searches for places which have this given street address. There are other well-known, and application specific attributes… |
| callback | string | no | If supplied, the response will use the JSONP format with a callback of the given name. |

### Locates places near the given coordinates which are similar in name. Conceptually you would use this method…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/geo-similar-places`

| Parameter | Type | Required | Description |
|---|---|---|---|
| contained_within | string | no | This is the place_id which you would like to restrict the search results to. Setting this value means only places within the given… |
| attribute:street_address | string | no | This parameter searches for places which have this given street address. There are other well-known, and application specific attributes… |
| callback | string | no | If supplied, the response will use the JSONP format with a callback of the given name. |

### Returns the current configuration used by Twitter including twitter.com slugs which are not usernames,…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/help-configurations`

### Returns the list of languages supported by Twitter along with their ISO 639-1 code. The ISO 639-1 code is…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/help-languages`

### Returns Twitter's Privacy Policy
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/help-privacy`

### Returns the Twitter Terms of Service in the requested format. These are not the same as the Developer Rules…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/help-tos`

### Creates a new list for the authenticated user. Note that you can't create more than 20 lists per account.
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/lists-create`

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | The name for the list.A list's name must start with a letter and can consist only of 25 or fewer letters, numbers, "-", or "_" characters. |
| mode | string | no | Whether your list is public or private. Values can be public or private. If no mode is specified the list will be public. |
| description | string | no | The description to give the list. |

### Deletes the specified list. The authenticated user must own the list to be able to destroy it.
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/lists-destroy`

| Parameter | Type | Required | Description |
|---|---|---|---|
| owner_screen_name | string | no | The screen name of the user who owns the list being requested by a slug. |
| owner_id | string | no | The user ID of the user who owns the list being requested by a slug. |

### Returns all lists the authenticating or specified user subscribes to, including their own. The user is…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/lists-list`

| Parameter | Type | Required | Description |
|---|---|---|---|
| screen_name | string | yes | The screen name of the user for whom to return results for. Helpful for disambiguating when a valid screen name is also a user ID. Example… |
| user_id | string | yes | The ID of the user for whom to return results for. Helpful for disambiguating when a valid user ID is also a valid screen name. Example… |

### Returns the members of the specified list. Private list members will only be shown if the authenticated user…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/lists-members`

| Parameter | Type | Required | Description |
|---|---|---|---|
| owner_screen_name | string | no | The screen name of the user who owns the list being requested by a slug. |
| owner_id | string | no | The user ID of the user who owns the list being requested by a slug. |
| include_entities | string | no | The entities node will be disincluded when set to false. Example Values: false |
| skip_status | string | no | When set to either true, t or 1 statuses will not be included in the returned user objects. |
| cursor | string | no | Causes the collection of list members to be broken into "pages" of somewhat consistent size. If no cursor is provided, a value of -1 will… |

### Add a member to a list. The authenticated user must own the list to be able to add members to it. Note that…
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/lists-members-create`

| Parameter | Type | Required | Description |
|---|---|---|---|
| owner_screen_name | string | no | The screen name of the user who owns the list being requested by a slug. |
| owner_id | string | no | The user ID of the user who owns the list being requested by a slug. |

### Adds multiple members to a list, by specifying a comma-separated list of member ids or screen names. The…
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/lists-members-create-all`

| Parameter | Type | Required | Description |
|---|---|---|---|
| owner_screen_name | string | no | The screen name of the user who owns the list being requested by a slug. |
| owner_id | string | no | The user ID of the user who owns the list being requested by a slug. |
| user_id | string | no | A comma separated list of user IDs, up to 100 are allowed in a single request. |
| screen_name | string | no | A comma separated list of screen names, up to 100 are allowed in a single request. |

### Removes the specified member from the list. The authenticated user must be the list's owner to remove…
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/lists-members-destroy`

| Parameter | Type | Required | Description |
|---|---|---|---|
| list_id | string | yes | The numerical id of the list. |
| slug | string | yes | You can identify a list by its slug instead of its numerical id. If you decide to do so, note that you'll also have to specify the list… |
| owner_screen_name | string | no | The screen name of the user who owns the list being requested by a slug. |
| owner_id | string | no | The user ID of the user who owns the list being requested by a slug. |
| user_id | string | no | The ID of the user to remove from the list. Helpful for disambiguating when a valid user ID is also a valid screen name. |
| screen_name | string | no | The screen name of the user for whom to remove from the list. Helpful for disambiguating when a valid screen name is also a user ID. |

### Removes multiple members from a list, by specifying a comma-separated list of member ids or screen names.…
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/lists-members-destroy-all`

| Parameter | Type | Required | Description |
|---|---|---|---|
| owner_screen_name | string | no | The screen name of the user who owns the list being requested by a slug. |
| owner_id | string | no | The user ID of the user who owns the list being requested by a slug. |
| screen_name | string | no | A comma separated list of screen names, up to 100 are allowed in a single request. |
| user_id | string | no | A comma separated list of user IDs, up to 100 are allowed in a single request. |

### Check if the specified user is a member of the specified list.
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/lists-members-show`

| Parameter | Type | Required | Description |
|---|---|---|---|
| owner_screen_name | string | no | The screen name of the user who owns the list being requested by a slug. |
| owner_id | string | no | The user ID of the user who owns the list being requested by a slug. |
| include_entities | string | no | When set to either true, t or 1, each tweet will include a node called "entities". This node offers a variety of metadata about the tweet… |
| skip_status | string | no | When set to either true, t or 1 statuses will not be included in the returned user objects. |

### Returns the lists the specified user has been added to. If user_id or screen_name are not provided the…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/lists-memberships`

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | no | The ID of the user for whom to return results for. Helpful for disambiguating when a valid user ID is also a valid screen name. |
| screen_name | string | no | The screen name of the user for whom to return results for. Helpful for disambiguating when a valid screen name is also a user ID. |
| cursor | string | no | Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned in the… |
| filter_to_owned_lists | string | no | When set to true, t or 1, will return just lists the authenticating user owns, and the user represented by user_id or screen_name is a… |

### Returns the specified list. Private lists will only be shown if the authenticated user owns the specified…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/lists-show`

| Parameter | Type | Required | Description |
|---|---|---|---|
| owner_screen_name | string | no | The screen name of the user who owns the list being requested by a slug. |
| owner_id | string | no | The user ID of the user who owns the list being requested by a slug. |

### Returns tweet timeline for members of the specified list. Retweets are included by default. You can use the…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/lists-statuses`

| Parameter | Type | Required | Description |
|---|---|---|---|
| owner_screen_name | string | no | The screen name of the user who owns the list being requested by a slug. |
| owner_id | string | no | The user ID of the user who owns the list being requested by a slug. |
| since_id | string | no | Returns results with an ID greater than (that is, more recent than) the specified ID. There are limits to the number of Tweets which can… |
| max_id | string | no | Returns results with an ID less than (that is, older than) or equal to the specified ID. |
| count | string | no | Specifies the number of results to retrieve per "page. |
| include_entities | string | no | Entities are ON by default in API 1.1, each tweet includes a node called "entities". This node offers a variety of metadata about the… |
| include_rts | string | yes | When set to either true, t or 1, the list timeline will contain native retweets (if they exist) in addition to the standard stream of… |

### Returns the subscribers of the specified list. Private list subscribers will only be shown if the…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/lists-subscribers`

| Parameter | Type | Required | Description |
|---|---|---|---|
| owner_screen_name | string | no | The screen name of the user who owns the list being requested by a slug. |
| owner_id | string | no | The user ID of the user who owns the list being requested by a slug. |
| cursor | string | no | Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned in the… |
| include_entities | string | no | When set to either true, t or 1, each tweet will include a node called "entities". This node offers a variety of metadata about the tweet… |
| skip_status | string | no | When set to either true, t or 1 statuses will not be included in the returned user objects. |

### Subscribes the authenticated user to the specified list.
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/lists-subscribers-create`

| Parameter | Type | Required | Description |
|---|---|---|---|
| owner_screen_name | string | no | The screen name of the user who owns the list being requested by a slug. |
| owner_id | string | no | The user ID of the user who owns the list being requested by a slug. |

### Unsubscribes the authenticated user from the specified list.
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/lists-subscribers-destroy`

| Parameter | Type | Required | Description |
|---|---|---|---|
| owner_screen_name | string | no | The screen name of the user who owns the list being requested by a slug. |
| owner_id | string | no | The user ID of the user who owns the list being requested by a slug. |

### Check if the specified user is a subscriber of the specified list. Returns the user if they are subscriber.
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/lists-subscribers-show`

| Parameter | Type | Required | Description |
|---|---|---|---|
| owner_screen_name | string | no | The screen name of the user who owns the list being requested by a slug. |
| owner_id | string | no | The user ID of the user who owns the list being requested by a slug. |
| include_entities | string | no | When set to either true, t or 1, each tweet will include a node called "entities". This node offers a variety of metadata about the tweet… |
| skip_status | string | no | When set to either true, t or 1 statuses will not be included in the returned user objects. |

### Obtain a collection of the lists the specified user is subscribed to, 20 lists per page by default. Does not…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/lists-subscriptions`

| Parameter | Type | Required | Description |
|---|---|---|---|
| count | string | no | The amount of results to return per page. Defaults to 20. Maximum of 1,000 when using cursors. |
| cursor | string | no | Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned in the… |

### Updates the specified list. The authenticated user must own the list to be able to update it.
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/lists-update`

| Parameter | Type | Required | Description |
|---|---|---|---|
| owner_screen_name | string | no | The screen name of the user who owns the list being requested by a slug. |
| owner_id | string | no | The user ID of the user who owns the list being requested by a slug. |
| name | string | no | The name for the list. |
| mode | string | no | Whether your list is public or private. Values can be public or private. If no mode is specified the list will be public. |
| description | string | no | The description to give the list. |

### Create a new saved search for the authenticated user. A user may only have 25 saved searches.
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/saved-searches-create`

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | yes | The query of the search the user would like to save. |

### Destroys a saved search for the authenticating user. The authenticating user must be the owner of saved…
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/saved-searches-destroy`

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the saved search. Example Values: 313006 |

### Returns the authenticated user's saved search queries.
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/saved-searches-list`

### Returns the authenticated user's saved search queries.
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/savedsearchesid`

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the saved search. Example Values: 313006 |

### Returns a collection of relevant Tweets matching a specified query. Please note that Twitter's search…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/search-tweets`

| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | yes | A UTF-8, URL-encoded search query of 1,000 characters maximum, including operators. Queries may additionally be limited by… |
| geocode | string | no | Returns tweets by users located within a given radius of the given latitude/longitude. The location is preferentially taking from the… |
| lang | string | no | Restricts tweets to the given language, given by an ISO 639-1 code. Language detection is best-effort.Example Values: eu |
| locale | string | no | Specify the language of the query you are sending (only ja is currently effective). This is intended for language-specific consumers and… |
| result_type | string | no | Optional. Specifies what type of search results you would prefer to receive. The current default is "mixed." Valid values include: *… |
| count | string | no | The number of tweets to return per page, up to a maximum of 100. Defaults to 15. This was formerly the "rpp" parameter in the old Search… |
| until | string | no | Returns tweets generated before the given date. Date should be formatted as YYYY-MM-DD. Keep in mind that the search index may not go back… |
| since_id | string | no | Returns results with an ID greater than (that is, more recent than) the specified ID. There are limits to the number of Tweets which can… |
| max_id | string | no | Returns results with an ID less than (that is, older than) or equal to the specified ID. Example Values: 12345 |
| include_entities | string | no | The entities node will be disincluded when set to false. Example Values: false |
| callback | string | no | If supplied, the response will use the JSONP format with a callback of the given name. The usefulness of this parameter is somewhat… |

### Destroys the status specified by the required ID parameter. The authenticating user must be the author of…
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/statuses-destroy`

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The numerical ID of the desired status. |
| trim_user | string | no | When set to either true, t or 1, each tweet returned in a timeline will include a user object including only the status authors numerical… |

### Returns a collection of the most recent Tweets and retweets posted by the authenticating user and the users…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/statuses-home-timeline`

| Parameter | Type | Required | Description |
|---|---|---|---|
| count | integer | no | Specifies the number of records to retrieve. Must be less than or equal to 200. |
| max_id | integer | no | Returns results with an ID less than (that is, older than) or equal to the specified ID. |
| since_id | integer | no | Returns results with an ID greater than (that is, more recent than) the specified ID. There are limits to the number of Tweets which can… |
| trim_user | string | no | When set to either true, t or 1, each tweet returned in a timeline will include a user object including only the status authors numerical… |
| exclude_replies | string | no | This parameter will prevent replies from appearing in the returned timeline. Using exclude_replies with the count parameter will mean you… |
| contributor_details | string | no | This parameter enhances the contributors element of the status response to include the screen_name of the contributor. By default only the… |

### Returns the 20 most recent mentions (tweets containing a users's @screen_name) for the authenticating…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/statuses-mentions-timeline`

| Parameter | Type | Required | Description |
|---|---|---|---|
| count | integer | no | Specifies the number of tweets to try and retrieve, up to a maximum of 200. The value of count is best thought of as a limit to the number… |
| since_id | integer | no | Returns results with an ID greater than (that is, more recent than) the specified ID. There are limits to the number of Tweets which can… |
| max_id | integer | no | Returns results with an ID less than (that is, older than) or equal to the specified ID. |
| trim_user | string | no | When set to either true, t or 1, each tweet returned in a timeline will include a user object including only the status authors numerical… |
| contributor_details | string | no | This parameter enhances the contributors element of the status response to include the screen_name of the contributor. By default only the… |
| include_entities | boolean | no | The entities node will be disincluded when set to false. |

### Returns information allowing the creation of an embedded representation of a Tweet on third party sites. See…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/statuses-oembed`

| Parameter | Type | Required | Description |
|---|---|---|---|
| maxwidth | integer | no | The maximum width in pixels that the embed should be rendered at. This value is constrained to be between 250 and 550 pixels. Note that… |
| hide_media | string | no | Specifies whether the embedded Tweet should automatically expand images which were uploaded via POST statuses/update_with_media. When set… |
| hide_thread | string | no | Specifies whether the embedded Tweet should automatically show the original message in the case that the embedded Tweet is a reply. When… |
| omit_script | string | no | Specifies whether the embedded Tweet HTML should include a 'script' element pointing to widgets.js. In cases where a page already includes… |
| align | string | no | Specifies whether the embedded Tweet should be left aligned, right aligned, or centered in the page. Valid values are left, right, center,… |
| related | string | no | A value for the TWT related parameter, as described in Web Intents (https://dev.twitter.com/docs/intents). This value will be forwarded to… |
| lang | string | no | Language code for the rendered embed. This will affect the text and localization of the rendered HTML. Example value: fr |

### Retweets a tweet. Returns the original tweet with retweet details embedded.
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/statusesretweetid`

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The numerical ID of the desired status. |
| trim_user | string | no | When set to either true, t or 1, each tweet returned in a timeline will include a user object including only the status authors numerical… |

### Returns up to 100 of the first retweets of a given tweet.
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/statuses-retweets`

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The numerical ID of the desired status. |
| count | string | no | Specifies the number of records to retrieve. Must be less than or equal to 100. |
| trim_user | string | no | When set to either true, t or 1, each tweet returned in a timeline will include a user object including only the status authors numerical… |

### Returns a single status, specified by the id parameter below. The status's author will be returned inline.
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/statuses-show`

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The numerical ID of the desired status. |
| trim_user | string | no | When set to either true, t or 1, each tweet returned in a timeline will include a user object including only the status authors numerical… |
| include_my_retweet | string | no | When set to either true, t or 1, any Tweets returned that have been retweeted by the authenticating user will include an additional… |
| include_entities | string | no | The entities node will be disincluded when set to false. |

### Updates the authenticating user's status, also known as tweeting. To upload an image to accompany the tweet,…
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/statuses-update`

| Parameter | Type | Required | Description |
|---|---|---|---|
| status | string | yes | The text of your status update, typically up to 140 characters. URL encode as necessary. t.co link short-url wrapping… |
| in_reply_to_status_id | string | no | The ID of an existing status that the update is in reply to. Note: This parameter will be ignored unless the author of the tweet this… |
| lat | string | no | The latitude of the location this tweet refers to. This parameter will be ignored unless it is inside the range -90.0 to +90.0 (North is… |
| long | string | no | The longitude of the location this tweet refers to. The valid ranges for longitude is -180.0 to +180.0 (East is positive) inclusive. This… |
| place_id | string | no | A place in the world. These IDs can be retrieved from GET geo/reverse_geocode (https://dev.twitter.com/docs/api/1/get/geo/reverse_geocode). |
| display_coordinates | string | no | Whether or not to put a pin on the exact coordinates a tweet has been sent from. |
| trim_user | string | no | When set to either true, t or 1, each tweet returned in a timeline will include a user object including only the status authors numerical… |

### Updates the authenticating user's status and attaches media for upload. Unlike POST statuses/update…
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/statuses-update-with-media`

| Parameter | Type | Required | Description |
|---|---|---|---|
| status | string | yes | The text of your status update. URL encode as necessary. t.co link wrapping (https://dev.twitter.com/docs/tco-link-wrapper/faq) may affect… |
| media | string | yes | Up to max_media_per_upload files may be specified in the request, each named media[]. Supported image formats are PNG, JPG and GIF.… |
| possibly_sensitive | string | no | Set to true for content which may not be suitable for every audience. |
| in_reply_to_status_id | string | no | The ID of an existing status that the update is in reply to. Note: This parameter will be ignored unless the author of the tweet this… |
| lat | string | no | The latitude of the location this tweet refers to. This parameter will be ignored unless it is inside the range -90.0 to +90.0 (North is… |
| long | string | no | The longitude of the location this tweet refers to. The valid ranges for longitude is -180.0 to +180.0 (East is positive) inclusive. This… |
| place_id | string | no | A place in the world identified by a Twitter place ID. Place IDs can be retrieved from geo/reverse_geocode. |
| display_coordinates | string | no | Whether or not to put a pin on the exact coordinates a tweet has been sent from. |

### Returns the 20 most recent statuses posted by the authenticating user. It is also possible to request…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/statuses-user-timeline`

| Parameter | Type | Required | Description |
|---|---|---|---|
| count | integer | no | Specifies the number of tweets to try and retrieve, up to a maximum of 200. The value of count is best thought of as a limit to the number… |
| since_id | integer | no | Returns results with an ID greater than (that is, more recent than) the specified ID. There are limits to the number of Tweets which can… |
| max_id | integer | no | Returns results with an ID less than (that is, older than) or equal to the specified ID. |
| trim_user | string | no | When set to either true, t or 1, each tweet returned in a timeline will include a user object including only the status authors numerical… |
| exclude_replies | boolean | no | This parameter will prevent replies from appearing in the returned timeline. Using exclude_replies with the count parameter will mean you… |
| contributor_details | boolean | no | This parameter enhances the contributors element of the status response to include the screen_name of the contributor. By default only the… |
| include_rts | boolean | no | When set to false, the timeline will strip any native retweets (though they will still count toward both the maximal length of the… |

### Returns the locations that Twitter has trending topic information for. The response is an array of…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/trends-available`

### Returns the locations that Twitter has trending topic information for, closest to a specified location. The…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/trends-closest`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lat | string | no | If provided with a long parameter the available trend locations will be sorted by distance, nearest to furthest, to the co-ordinate pair.… |
| long | string | no | If provided with a lat parameter the available trend locations will be sorted by distance, nearest to furthest, to the co-ordinate pair.… |

### Returns the top 10 trending topics for a specific WOEID, if trending information is available for it. The…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/trends-place`

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The Yahoo! Where On Earth ID of the location to return trending information for. Global information is available by using 1 as the WOEID. |
| exclude | string | no | Setting this equal to hashtags will remove all hashtags from the trends list. |

### Returns a collection of users that the specified user can contribute to.
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/users-contributees`

| Parameter | Type | Required | Description |
|---|---|---|---|
| include_entities | string | no | The entities node will be disincluded when set to false. Example Values: false |
| skip_status | string | no | When set to either true, t or 1 statuses will not be included in the returned user objects. |

### Returns a collection of users who can contribute to the specified account.
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/users-contributors`

| Parameter | Type | Required | Description |
|---|---|---|---|
| include_entities | string | no | The entities node will be disincluded when set to false. Example Values: false |
| skip_status | string | no | When set to either true, t or 1 statuses will not be included in the returned user objects. |

### Returns fully-hydrated user objects for up to 100 users per request, as specified by comma-separated values…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/users-lookup`

| Parameter | Type | Required | Description |
|---|---|---|---|
| screen_name | string | no | A comma separated list of screen names, up to 100 are allowed in a single request. You are strongly encouraged to use a POST for larger… |
| user_id | string | no | A comma separated list of user IDs, up to 100 are allowed in a single request. You are strongly encouraged to use a POST for larger… |
| include_entities | string | no | The entities node that may appear within embedded statuses will be disincluded when set to false. Example Values: false |

### The user specified in the id is blocked by the authenticated user and reported as a spammer.
`POST https://zieapi.vercel.app/v1/social-media:twitter-legacy/users-report-spam`

### Provides a simple, relevance-based search interface to public user accounts on Twitter. Try querying by…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/users-search`

| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | yes | The search query to run against people search. Example Values: Twitter%20API |
| page | string | no | Specifies the page of results to retrieve. Example Values: 3 |
| count | string | no | The number of potential user results to retrieve per page. This value has a maximum of 20. Example Values: 5 |
| include_entities | string | no | The entities node will be disincluded when set to false. Example Values: false |

### Returns a variety of information about the user specified by the required user_id or screen_name parameter.…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/users-show`

| Parameter | Type | Required | Description |
|---|---|---|---|
| screen_name | string | yes | The screen name of the user for whom to return results for. Either a id or screen_name is required for this method. Example Values: noradio |
| user_id | string | yes | The ID of the user for whom to return results for. Either an id or screen_name is required for this method. Example Values: 12345 |
| include_entities | string | no | The entities node will be disincluded when set to false. Example Values: false |

### Access to Twitter's suggested user list. This returns the list of suggested user categories. The category…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/users-suggestions`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Restricts the suggested categories to the requested language. The language must be specified by the appropriate two letter ISO 639-1… |

### Access the users in a given category of the Twitter suggested user list. It is recommended that applications…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/users-suggestions-slug`

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes | The short name of list or a category Example Values: twitter |
| lang | string | no | Restricts the suggested categories to the requested language. The language must be specified by the appropriate two letter ISO 639-1… |

### Access the users in a given category of the Twitter suggested user list and return their most recent status…
`GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/users-suggestionsslugmembers`

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes | The short name of list or a category Example Values: twitter |

## Example
```
curl "https://zieapi.vercel.app/v1/social-media:twitter-legacy/account-settings-get" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the Twitter API API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/social-media:twitter-legacy/account-settings-get with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Twitter API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the Twitter API API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key social-media:twitter-legacy.

### What is the status of the Twitter API API?
Live: works with just an Apizie key