Twitter Developer Labs
-
Build an API to create and retrieve Tweet threads
Tweet threads have become increasingly popular over the past few years. This API would enable developers to tap into the potential of threads by programmatically creating threads, as well as retrieving all Tweets in a thread.
86 votes -
API to report abuse/inappropriate content
I suggest that the report features extend to API users. Report abuse is only available for individuals who get exposed to, click, and decide to report a tweet/account.
A lot of inappropriate content is unfortunately on twitter. Perhaps I could categorize into 4 types:
(1) inappropriate language: hate speech, harassment (bullying, sexual harassment)
(2) inappropriate image: pornography, graphic violence
(3) intention for inappropriate and harmful activities: intention to commit a crime (shooting, bomb, individual or mass threats), sell inappropriate products and services (prostitution, drugs - not debating if it is illegal or not, but I think twitter shouldn't be the…58 votes -
Allow access to DM group conversations via Twitter API
Currently we can access 1on1 DM via Twitter API but not group conversations. If we forcibly set the group's conversation_id, Twitter API returns forbidden. Allow this.
ref
https://developer.twitter.com/en/docs/direct-messages/sending-and-receiving/api-reference/new-event49 votesMarking this suggestion as “closed” for now, as this is not currently a priority
-
Build a conversation updates API
I would like to recommend building a conversations API that enables developers to track updates to full conversation threads. This API would retrieve the entire conversation that a Tweet is in, and return all Tweets and replies within a given thread. This API would enable developers to go from a Tweet of interest to all replies in the thread, without having to recursively search for Tweets with the correct "inreplytostatusid".
42 votes -
Twitter should provide more granular app permissions
Twitter currently offers three levels of app permissions: (1) read only; (2) read and write; (3) read, write and access Direct Messages. These options are not granular enough for some developers, and developers would like more options to choose from.
For example, an app’s “write” permission could be segmented into more granular options: (1) write access to a user’s profile; (2) write access to a user’s network (follow/unfollow, mute, block, list modification); (3) write access to a user’s timeline, including the permission to Tweet, Retweet, or like a post.
Another example includes Sign In With Twitter: there could be an…
39 votes -
Build an API to manage polls and poll results
Having access to an API for Twitter native polls would enable developers to create and schedule polls, as well as get back engagement data such as impressions, responses, Retweets of the poll, and their resulting responses, reach, and total engagement.
37 votesSome poll information has now been made available in Labs: https://developer.twitter.com/en/docs/labs/overview/whats-new/expansions
-
alt text via API
Images in tweets should have their alt text available via API. Make it obvious. Here is where I would have expected to find it: https://developer.twitter.com/en/docs/tweets/data-dictionary/overview/entities-object#media
35 votesThanks for the feedback! While we are aware of this ask, we will not be able to prioritize this in the near future. Please keep voting for this idea if it resonated with you.
-
Add an Endpoint for Aggregate Video Metrics Across Tweets
It would be really helpful to have an analytics endpoint in which the entity was a media ID (in my case a video ID) and you could request engagement & video metrics aggregated at the video level, even if that video appeared across many different tweets. Right now this is possible through the Engagement API for video views only, but it would be great if it were available through the Ads API & included seconds/minutes viewed, percentile completions, call to action clicks, etc.
34 votes -
Add a filter to return only currently promoted tweets
Currently there is no way to only return promoted tweets. With a "filter:promoted" filter option, it would be possible to only return promoted tweets combined with other search terms.
This feature would help researchers and increase ad transparency.
20 votesWe appreciate the feedback, but this is not on our roadmap for the near-term future. Hence marking as “closed”.
-
Be able to get all the retweeters ids instead of the last 100 only
It would be useful to be able to retrieve more than 100 results calling GET statuses/retweeters/ids
The current limitation doesn't make sense.18 votes -
Provide developers with an API testing console
As a new developer, I want a lightweight way to make an API call within the documentation with little setup involved. I need to see and evaluate quickly what a request and response looks like for a specific endpoint.
17 votes -
Accept or deny follower requests (when tweets are protected)
It will be really useful to be able to accept/deny follower requests with Twitter API when tweets are protected.
This feature exists but currently this is not public.When I try to call this endpoint :
POST https://api.twitter.com/1.1/friendships/accept.json?user_id=<follower id>
I've received : {"errors":[{"code":37,"message":"Not authorized to use this endpoint."}]} - HTTP Code : 403
16 votesThanks for the feedback. This is most certainly something that we will be considering as we build the next generation of the Twitter API.
-
Make the endpoint rate limited at user level instead of app level
We have built a social media management app that allows our customers to also view insights for their social accounts and posts.
Every midnight we refresh insights for all posts published via our app in the past 7 days.
For Twitter, we're only recording the number of favorites and retweets (returned by the /tweets endpoint), but we would like to gather more metrics, such as impressions, # of replies and video views.
The current rate limit is 15 requests / 15 minutes and 50 Tweets / request.
This basically means we can gather metrics for only 15 customers at a…
15 votes -
Add Endpoint to get retweet with comment aka 'Quote tweet'
Create endpoint for get "quote tweets" by other to Tweets authored by the user. Like endpoint statuses/retweetsofme.
14 votesNote that you can now filter quote Tweets with Filtered stream in Labs using the `is:quote` operator: https://developer.twitter.com/en/docs/labs/filtered-stream/operators
Combined with other operators, this is a first step towards what you are describing. -
Consistency for "Likes" and "Favorites"
Language consistency would be helpful.
API Representation uses "favorites", but the current Twitter interface uses "likes".
In the documentation for "Account Activity API" notes "likes", while in "Search Tweets" notes as "favorites".
Perhaps not all of us are aware that "favorites" is a precedent of "likes".
13 votes -
GET statuses/likers/ids endpoint
Why don't we have the same kind of statuses/retweeters/ids endpoint but for likes, in order to get all the user ids who liked a particular tweet ?
11 votesThanks for the request & details. We don’t yet have plans to address this, but I have shared your request with the Product team for future consideration.
-
API response should contain descriptive error messages for actions that are forbidden
When I try to hide a Tweet in a thread that wasn’t started by the authenticating user, I get the response:
(
[title] => Forbidden
[type] => about:blank
[status] => 403
[detail] => Forbidden
)I understand that this action should actually be forbidden, but the error in the API response doesn't tell me why the action is forbidden (which is that the authenticating user is trying to hide a Tweet in a thread that wasn't started by the authenticating user)
11 votes -
Build a more accessible version of the engagement metrics API
Twitter could build a more affordable version of the enterprise Engagement API, which would provide developers with Tweet metrics for owned Tweets.
Engagement data returned by the API includes number of Likes, Retweets, replies, impressions, and engagements (for example, number of link clicks). This API would enable developers to better understand their reach and impact on Twitter.
11 votes -
Add a field to signal when media is being withheld by country
Add a field to know when media is being withheld by country
9 votes -
Fully adopt OAuth 2.0
I would like the Twitter API to use OAuth 2.0 instead of OAuth 1.0. OAuth1.0a is fairly specific to the Twitter APIs at this point in time. It's complicated to implement, and there is a dwindling number of developer tools that support it. OAuth 2.0 is less complicated and easier to build into an app than OAuth 1.0.
9 votesMarking as “closed” as we are unable to invest in fully migrating to OAuth 2.0 at this time.
- Don't see your idea?