Rate limits

Reading the headers

You can log ratelimits natively in emusks with:

client.onResponse = ({ name, headers }) => {
  const header = (key) => [Object.entries(headers).find(([k]) => k.toLowerCase() === key)?.[1]].flat()[0];
  const remaining = Number(header("x-rate-limit-remaining"));
  const reset = Number(header("x-rate-limit-reset"));
  if (remaining < 5) console.log(`${name}: ${remaining} left until ${new Date(reset * 1000).toISOString()}`);
};

When a GraphQL request fails, the error has status and rateLimit, an object with limit, remaining and reset. client.account.rateLimitStatus() returns Twitter's own table for the v1.1 endpoints, and the full list is at the bottom of this page.

GraphQL queries

Query	emusks helpers	Authed	Guest
AboutAccountQuery	users.about	50	❌
AudioSpaceSearch	spaces.search	500	❌
BirdwatchFetchGlobalTimeline	notes.globalTimeline	500	❌
BirdwatchFetchNotes	notes.forTweet	500	❌
BlockedAccountsAll	users.blocked	500	❌
BlueVerifiedFollowers	users.verifiedFollowers	500	❌
BookmarkFoldersSlice	bookmarks.folders	500	❌
Bookmarks	bookmarks.get	500	❌
CommunitiesExploreTimeline	communities.explore	500	❌
CommunityAboutTimeline	communities.about	50	50
CommunityByRestId	communities.get	500	❌
CommunityTweetsTimeline	communities.timeline, communities.top	500	❌
ConnectTabTimeline	timelines.connect	500	❌
ExplorePage	trends.explore	500	❌
ExploreSidebar	trends.exploreSidebar	500	❌
Favoriters	tweets.likers	500	❌
FetchScheduledTweets	tweets.getScheduled	500	❌
Followers	users.followers	50	❌
FollowersYouKnow	users.followersYouKnow	500	❌
Following	users.following	500	❌
GlobalCommunitiesPostSearchTimeline	search.communities	50	❌
HomeLatestTimeline	timelines.homeLatest	500	❌
HomeTimeline	timelines.home	500	❌
ListByRestId	lists.get	500	❌
ListLatestTweetsTimeline	lists.timeline	500	❌
ListMembers	lists.members	500	❌
ListMemberships	lists.listMemberships	500	❌
ListOwnerships	lists.ownerships	500	❌
ListsDiscovery	lists.discover	500	❌
ListSubscribers	lists.subscribers	500	❌
MutedAccounts	users.muted	500	❌
NotificationsTimeline	notifications.timeline	1500	❌
PinnableTimelines	timelines.topics	50	50
PinnedTimelines	lists.pinned	500	❌
Retweeters	tweets.retweeters	500	❌
SearchTimeline	search.tweets, search.users, search.media, search.latest, search.lists	50	❌
SimilarPosts	tweets.similar	500	❌
TopicToFollowSidebar	topics.toFollow	500	❌
TweetDetail	tweets.detail	300	❌
TweetEditHistory	tweets.editHistory	500	❌
TweetResultByRestId	tweets.get	500	500
TweetResultsByRestIds	articles.forTweet, tweets.getMany	500	❌
UserArticlesTweets	articles.byUser	500	❌
UserByRestId	users.get	500	500
UserByScreenName	users.getByUsername	150	150
useRelayDelegateDataQuery	delegates.groups	150	150
UserHighlightsTweets	users.highlights	50	50
UserMedia	users.userMedia	500	❌
UserOriginalsTimeline	users.popular, users.originals	250	❌
UserRepostsTimeline	users.reposts	50	❌
UsersByRestIds	users.getMany	100	❌
UsersByScreenNames	users.getManyByUsername	50	❌
UserTweets	users.tweets	50	50
UserTweetsAndReplies	users.replies	500	500
Viewer	account.viewer	100	100

Guest access changes between runs. An earlier test, described on the guest tokens page, had tweets.getMany, tweets.similar and communities.get working as a guest, and this run got 404 on all three.

REST endpoints

Endpoint	emusks helpers	Authed	Guest
application/rate_limit_status	account.rateLimitStatus	180
dm/inbox_initial_state	dms.inbox	450	❌
get:account/settings	account.settings	100	❌
trends/available	trends.available	75	15
users/lookup	users.lookup	200	❌
users/recommendations	users.recommendations	60	60

trends.available is the only endpoint where a guest token gets a lower limit than an account, 15 against 75.

Other APIs

API	Limit
Syndication profiles, syndication.profile and syndication.profileById	30 per window, per IP

Daily account limits

Twitter's help center lists limits per account per day on top of the per-window ones. These are a few known, documented limits. These are randomly outdated since Twitter doesn't do a great job of updating their docs.

Action	Limit
Direct messages	500 per day
Posts, including replies and reposts	2,400 per day, split into smaller semi-hourly limits
Posts from unverified accounts	50 original posts and 200 replies per day (? might have changed)
Follows	400 per day
Email address changes	4 per hour
Users added to a list with lists.addMember	150 per list per day (source)

v1.1 resources

This includes endpoints that are no longer available or that emusks doesn't support.

Resource	Limit per 15 minutes
/:version/friendships/destroy	100
/{:Version}/moments/set_cover/{moment_id:Long}	180
/1.1/blocks/destroy.json	100
/1.1/keyregistry/extract_public_keys	500
/1/friendships/destroy/:id	100
/account_activity/all/:instance_name/subscriptions	500
/account_activity/all/:instance_name/webhooks	15
/account_activity/all/webhooks	15
/account_activity/direct_messages/:instance_name/subscriptions	15
/account_activity/direct_messages/:instance_name/webhooks	15
/account_activity/direct_messages/webhooks	15
/account_activity/webhooks	15
/account_activity/webhooks/:id/subscriptions	500
/account_activity/webhooks/:id/subscriptions/all	500
/account_activity/webhooks/:id/subscriptions/all/list	15
/account_activity/webhooks/:id/subscriptions/direct_messages	500
/account_activity/webhooks/:id/subscriptions/direct_messages/list	15
/account/authenticate_web_view	50
/account/backup_code	60
/account/beacon	15
/account/change_password	15
/account/login_verification_enrollment	15
/account/login_verification_enrollment_v2	100
/account/login_verification_request	120
/account/login_verification/remove_method	15
/account/multi/add	15
/account/multi/list	30
/account/multi/logout_all	15
/account/multi/switch	15
/account/personalization/app_graph	180
/account/personalization/appgraph/optout_status	180
/account/personalization/download_advertiser_list	15
/account/personalization/download_your_data	15
/account/personalization/p13n_data	180
/account/personalization/p13n_preferences	900
/account/personalization/partner_interests	180
/account/personalization/set_optout_cookies	180
/account/personalization/twitter_interests	180
/account/profile_banner	180
/account/settings	180
/account/update_profile	15
/account/verification	180
/account/verify_credentials	2000
/account/verify_password	15
/activity/about_me	180
/activity/about_me/unread	15
/activity/by_friends	180
/activity/ds	15
/adaptive	900
/admin_users	2000
/ads/campaigns/account_permissions	15
/alerts/landing_page	180
/amplify/categories	75
/amplify/marketplace/defaults	200
/amplify/marketplace/videos	200
/application/rate_limit_status	180
/auth/csrf_token	15
/badge_count/badge_count	180
/beta/timelines/custom/list	180
/beta/timelines/custom/show	180
/beta/timelines/custom/whitelisted	15
/beta/timelines/timeline	300
/blocks/create&POST	400
/blocks/destroy.json&POST	1200
/blocks/exists	15
/blocks/ids	50
/blocks/list	15
/bookmark/entries/add&POST	180
/bookmark/entries/remove&POST	180
/bouncer/opt_in	15
/broadcasts/show	900
/business_experience/analytics/account	180
/business_experience/analytics/tweets	180
/business_experience/dashboard_features	450
/business_experience/dashboard_settings/destroy	450
/business_experience/dashboard_settings/show	450
/business_experience/dashboard_settings/update	450
/business_experience/inbox/interactions	450
/business_experience/inbox/show	150
/business_experience/keywords	450
/business_experience/twitter_pro_settings/destroy	450
/business_experience/twitter_pro_settings/show	450
/business_experience/twitter_pro_settings/update	450
/business_experience/user_features	450
/business_profiles/show	180
/business_profiles/update	180
/collections/entries	1000
/collections/list	1000
/collections/show	1000
/commerce/addresses	30
/commerce/payment_methods	30
/commerce/products	300
/commerce/profiles	30
/commerce/user_profiles	300
/communities/1/communities/create	1000
/communities/1/communities/show	5000
/communities/1/community/:id/join	5000
/communities/1/community/:id/leave	5000
/communities/1/community/:id/members	1000
/communities/1/community/:id/show	5000
/communities/1/community/:id/timeline	5000
/compliance/jobs/:job_id	150
/compliance/jobs&GET	150
/compliance/jobs&POST	150
/contacts/addressbook	300
/contacts/delete/status	300
/contacts/upload_and_match	20
/contacts/uploaded_by	300
/contacts/users	300
/contacts/users_and_uploaded_by	300
/content/recommendations	15
/conversation/hide	900
/conversation/show/:id	300
/conversation/unhide	900
/custom_profiles/list	180
/custom_profiles/show	180
/device_following/ids	180
/device_following/list	60
/device/install_referrer	18000
/device/operator_signup_info	15
/device/register	15
/device/sms_verify_begin	15
/device/token	100
/direct_messages	300
/direct_messages/broadcasts/list	60
/direct_messages/broadcasts/show	60
/direct_messages/broadcasts/statuses/list	60
/direct_messages/broadcasts/statuses/show	60
/direct_messages/events/list	15
/direct_messages/events/show	15
/direct_messages/mark_read	1000
/direct_messages/sent	300
/direct_messages/sent_and_received	300
/direct_messages/show	300
/direct_messages/subscribers/ids	180
/direct_messages/subscribers/lists/list	180
/direct_messages/subscribers/lists/members/ids	180
/direct_messages/subscribers/lists/members/show	1000
/direct_messages/subscribers/lists/show	180
/direct_messages/subscribers/show	180
/direct_messages/unread_count	300
/discover/highlight	300
/discover/home	300
/discover/nearby	300
/discover/universal	300
/dm/conversation/:id	900
/dm/conversation/:id/metadata	450
/dm/destroy	15
/dm/inbox_initial_state	450
/dm/inbox_timeline/:Id	450
/dm/permissions	450
/dm/permissions/secret	450
/dm/requests	450
/dm/top_requests	450
/dm/unread_count	60
/dm/user_inbox	450
/dm/user_updates	450
/drafts/statuses/create	450
/drafts/statuses/destroy	450
/drafts/statuses/ids	450
/drafts/statuses/list	450
/drafts/statuses/show	450
/drafts/statuses/update	450
/explore/tiles	30
/favorite_users/ids	180
/favorite_users/list	180
/favorites/list	180
/feedback/events	1000
/feedback/show/:id	180
/fleets/:version/avatar_content	100
/fleets/:version/create	50
/fleets/:version/delete	50
/fleets/:version/feedback/create	500
/fleets/:version/fleet_threads	1000
/fleets/:version/fleetline	100
/fleets/:version/home_timeline	100
/fleets/:version/mark_read	1000
/fleets/:version/mutes/create	100
/fleets/:version/mutes/destroy	100
/fleets/:version/mutes/list	100
/fleets/:version/track_events	100
/fleets/:version/update	50
/fleets/:version/user_fleets	180
/fleets/:version/viewers	100
/follow_search/show	60
/followers/ids	1000
/followers/list	1000
/followers/vit/ids	30
/followers/vit/list	30
/foundmedia/categories	150
/foundmedia/categories/:category	150
/foundmedia/search	300
/friends/following/ids	180
/friends/following/list	180
/friends/ids	1000
/friends/list	1000
/friends/vit/ids	30
/friends/vit/list	30
/friendships/create	15
/friendships/incoming	300
/friendships/list	200
/friendships/lookup	500
/friendships/no_retweets/ids	60
/friendships/outgoing	180
/friendships/show	800
/geo/id/:place_id	75
/geo/place_page	180
/geo/places	180
/geo/reverse_geocode	180
/geo/reverse_geocode/from_ip	600000
/geo/search	60
/geo/similar_places	15
/graph/app/optout/status	180
/graphql	2500
/graphql&POST	2500
/guide	180
/guide/explore_locations_with_autocomplete	800
/guide/get_explore_locations	100
/guide/get_explore_settings	200
/guide/topic	180
/help/configuration	180
/help/experiments	300
/help/languages	15
/help/privacy	180
/help/settings	180
/help/tos	180
/i/config	15
/i/tfb/v1/smb/web/:account_id/payment/save	15
/interests/suggestions	180
/keyregistry/delete&DELETE	15
/keyregistry/extract_prekey_bundle/:user_id&POST	100
/keyregistry/publish&POST	100
/keyregistry/register&POST	100
/labs/:version/tweets/:id/hidden&PUT	10
/labs/:version/tweets/*	900
/labs/:version/tweets/metrics/private	15
/labs/:version/tweets/search	225
/labs/:version/tweets/stream/compliance	500
/labs/:version/tweets/stream/filter/	50
/labs/:version/tweets/stream/filter/:instance_name	50
/labs/:version/tweets/stream/filter/rules/	450
/labs/:version/tweets/stream/filter/rules/:instance_name	450
/labs/:version/tweets/stream/filter/rules&POST	450
/labs/:version/tweets/stream/sample	50
/labs/:version/users/:id/tweets	225
/labs/:version/users/*	900
/labs/:version/users/by/username/:handle/tweets	225
/labs/2/platform_manipulation/reports	5
/labs/2/reports	5
/limiter_scalding_report_creation	4500
/limiter/ci_test/do/not/change&GET	4321
/lists/:id/followers&GET	180
/lists/:id/members/:user_id&DELETE	300
/lists/:id/members&GET	900
/lists/:id/members&POST	300
/lists/:id/tweets&GET	900
/lists/:id&DELETE	300
/lists/:id&GET	75
/lists/:id&PUT	300
/lists/list	180
/lists/members	900
/lists/members/show	15
/lists/memberships	180
/lists/ownerships	180
/lists/show	180
/lists/statuses	1800
/lists/subscribers	180
/lists/subscribers/show	15
/lists/subscriptions	180
/lists&POST	300
/live_event/1/:id/timeline	500
/live_event/timeline/:id	500
/live_pipeline/events	180
/live_video_stream/status/:id	1000
/live_video/1/:id/timeline	500
/media/upload	500
/mob_idsync_generate	15
/moments/annotate_timeline	180
/moments/capsule/:id	180
/moments/capsule/momentID	900
/moments/categories	300
/moments/categories/ttt_categories	300
/moments/create	180
/moments/curate_metadata/:id	180
/moments/curate/:id	180
/moments/delete	180
/moments/feedback	180
/moments/get_recommended_tweets	180
/moments/guide	180
/moments/like	300
/moments/list	300
/moments/list_categories	300
/moments/list_user_moments	300
/moments/modern_guide	180
/moments/permissions	300
/moments/pivot	180
/moments/publish	180
/moments/search	800
/moments/show/:id	180
/moments/sports/scores	180
/moments/statuses/update	5
/moments/subscribe	180
/moments/unlike	300
/moments/unsubscribe	180
/moments/update/:id	180
/moments/upsert	180
/moments/userlikes	300
/moments/users	300
/mutes/advanced_filters	100
/mutes/keywords/create	30
/mutes/keywords/destroy	30
/mutes/keywords/discouraged	15
/mutes/keywords/list	180
/mutes/users/ids	15
/mutes/users/list	50
/news/details	300
/news/rankings	300
/news/top	300
/notifications/:id	180
/notifications/:id/last_seen_cursor	180
/notifications/:id/unread_count	180
/notifications/settings/checkin	500
/notifications/settings/login	500
/notifications/settings/logout	500
/notifications/settings/save	500
/notifications/view/:id	180
/oauth/authenticate_periscope	150
/oauth/invalidate_token	450
/oauth/list	30
/oauth/revoke	15
/oauth/revoke_html	15
/offers	60
/onboarding/begin_verification	5
/paseto/token	100
/people_discovery/module	30
/people_discovery/modules	75
/permissions/user_permissions	3
/permissions/user_permissions/admin_email_verification	3
/profile_spotlight/show	180
/promoted_content/log	180
/prompts/record_event	180
/prompts/suggest	180
/push_destinations/device	15
/push_destinations/list	15
/related_results/show/:id	15
/safety/detection_feedback	450000
/sandbox/account_activity/webhooks/:id/subscriptions	500
/saved_searches/destroy/:id	15
/saved_searches/list	180
/saved_searches/show/:id	15
/search/adaptive	900
/search/integrated	180
/search/tweets	180
/search/typeahead	300
/search/universal	900
/searchrecordings/list	180
/searchrecordings/show	180
/special_events/world_cup_2014/countries/list	100
/special_events/world_cup_2014/settings	100
/stations/*	2000
/statuses/:id/activity	180
/statuses/:id/activity_summary	180
/statuses/:id/activity/summary	180
/statuses/favorited_by	180
/statuses/following_timeline	15
/statuses/friends	15
/statuses/home_timeline	600
/statuses/lookup	900
/statuses/media_timeline	1000
/statuses/mentions_timeline	180
/statuses/oembed	180
/statuses/retweeted_by	180
/statuses/retweeters/ids	75
/statuses/retweets_of_me	75
/statuses/retweets/:id	180
/statuses/show/:id	1000
/statuses/user_timeline	1000000000
/stickerprovider/catalog	60
/stickerprovider/stickers/:id	150
/storystream/stories	300
/strato/column/None/:id/cms/*	150
/strato/column/User/:id/account-security/twoFactorAuthSetting	100
/strato/column/User/:id/account-security/twoFactorAuthSettings	60
/strato/column/User/:id/notifications/	60
/strato/column/User/:id/search/searchSafetyReadonly	900
/streams/categories	180
/streams/recommended_modules	180
/streams/recommended_videos	180
/streams/related_users	180
/streams/stream	180
/teams/authorize	15
/tfb/v1/quick_promote/statuses/most_recently_active	180
/tfb/v1/quick_promote/statuses/timeline	180
/timeline/bookmark	1000
/timeline/conversation/:id	180
/timeline/favorites/:id	180
/timeline/home	180
/timeline/home_latest	300
/timeline/icymi	180
/timeline/liked_by	180
/timeline/list	300
/timeline/list_recommended_users	180
/timeline/media/:id	180
/timeline/profile/:id	180
/timeline/reactive	180
/timeline/retweeted_by	180
/timeline/user/:id	180
/timelines/hidden.json	50
/traffic/beacon-list	15
/traffic/map	15
/traffic/recommendations	15
/translations/show	90
/trends/available	75
/trends/closest	75
/trends/personalized	60
/trends/place	180
/trends/plus	300
/trends/timeline	300
/tv/shows/:id	180
/tv/telecasts/:id	180
/tweet_prompts/report_interaction	180
/tweet_prompts/show	180
/tweetdeck/clients	150
/tweetdeck/clients/blackbird	150
/tweetdeck/clients/blackbird/all	150
/tweetdeck/clients/pro	150
/tweetdeck/clients/pro/all	150
/tweetdeck/columns	150
/tweetdeck/dataminr/authtoken	15
/tweetdeck/feeds	150
/tweets/	900
/tweets/:id	900
/tweets/:id/hidden&PUT	50
/tweets/:id/retweeted_by	75
/tweets/:id&DELETE	50
/tweets/:tweet_id/liking_users	75
/tweets/counts/all	900
/tweets/counts/recent	900
/tweets/sample/stream	50
/tweets/search/:product/:instance/counts	900
/tweets/search/:product/:label	1800
/tweets/search/all	900
/tweets/search/recent	180
/tweets/search/stream	50
/tweets/search/stream/rules	450
/tweets/search/stream/rules/validation&POST	450
/tweets/search/stream/rules&DELETE	450
/tweets/search/stream/rules&POST	450
/tweets&POST	200
/urls/click	450
/urls/expand	450
/users_derived.info	1
/users/	900
/users/:id	900
/users/:id/blocking	15
/users/:id/blocking&POST	50
/users/:id/broadcasts/:id/state&PUT	30
/users/:id/broadcasts&POST	30
/users/:id/followed_lists/:list_id&DELETE	50
/users/:id/followed_lists&GET	15
/users/:id/followed_lists&POST	50
/users/:id/followers	15
/users/:id/following	15
/users/:id/liked_tweets	75
/users/:id/likes/:tweet_id&DELETE	50
/users/:id/likes&POST	50
/users/:id/list_memberships&GET	75
/users/:id/mentions	180
/users/:id/muting	15
/users/:id/muting&POST	50
/users/:id/owned_lists&GET	15
/users/:id/pinned_lists/:list_id&DELETE	50
/users/:id/pinned_lists&GET	15
/users/:id/pinned_lists&POST	50
/users/:id/retweets/:source_tweet_id&DELETE	50
/users/:id/retweets&POST	50
/users/:id/sources&GET	60
/users/:id/tweets	900
/users/:source_user_id/blocking/:target_user_id&DELETE	50
/users/:source_user_id/following/:target_user_id&DELETE	50
/users/:source_user_id/following&POST	50
/users/:source_user_id/muting/:target_user_id&DELETE	50
/users/by	900
/users/by/username/:handle/mentions	180
/users/by/username/:handle/tweets	900
/users/by/username/:source_username/following/:target_user_name&DELETE	50
/users/by/username/:source_username/following&POST	50
/users/by/username/:username	900
/users/by/username/:username/followers	15
/users/by/username/:username/following	15
/users/contributees	300
/users/contributees/pending	200
/users/contributors	300
/users/contributors/pending	2000
/users/derived_info	15
/users/email_phone_info	30
/users/extended_profile	180
/users/following_followers_of	15
/users/interests/timelines	15
/users/interests/topics	15
/users/lookup	900
/users/phone_number_available	15
/users/profile_banner	180
/users/recommendations	60
/users/report_spam	15
/users/reverse_lookup	100
/users/search	900
/users/send_invites_by_email	10
/users/show/:id	1000
/users/suggestions	180
/users/suggestions/:slug	180
/users/suggestions/:slug/members	180
/users/wipe_addressbook	10
/verify/:version/access	15
/verify/:version/account-eligibility	15
/verify/:version/badge-violation	15
/verify/:version/badge-violation/violations	15
/verify/:version/document-formats	15
/verify/:version/id-document&GET	1000
/verify/:version/id-document&POST	15
/verify/:version/intake	15
/videos/:type/config/:id	450
/videos/suggestions	180
/webhooks	15
/webhooks/subscriptions/direct_messages	15