Returns the current rate limits for methods belonging to the specified resource families.
Each 1.1 API resource belongs to a "resource family" which is indicated in its method documentation. You can typically determine a method's resource family from the first component of the path after the resource version.
This method responds with a map of methods belonging to the families specified by the resources parameter, the current remaining uses for each of those resources within the current rate limiting window, and its expiration time in epoch time. It also includes a rate_limit_context field that indicates the current access token or application-only authentication context.
You may also issue requests to this method without any parameters to receive a map of all rate limited GET methods. If your application only uses a few of methods, please explicitly provide a resources parameter with the specified resource families you work with.
When using app-only auth, this method's response indicates the app-only auth rate limiting context.
Read more about REST API Rate Limiting in v1.1 and review the limits.
Resource URL
Parameters
A comma-separated list of resource families you want to know the current rate limit disposition for. For best performance, only specify the resource families pertinent to your application.
See Rate Limiting in API v1.1 for more information.
Example Values: statuses,friends,trends,help
Example Request
GET | |
{
"rate_limit_context": {
"access_token": "786491-24zE39NUezJ8UTmOGOtLhgyLgCkPyY4dAcx6NA6sDKw"
},
"resources": {
"users": {
"/users/profile_banner": {
"limit": 180,
"remaining": 180,
"reset": 1403602426
},
"/users/suggestions/:slug/members": {
"limit": 15,
"remaining": 15,
"reset": 1403602426
},
"/users/show/:id": {
"limit": 180,
"remaining": 180,
"reset": 1403602426
},
"/users/suggestions": {
"limit": 15,
"remaining": 15,
"reset": 1403602426
},
"/users/lookup": {
"limit": 180,
"remaining": 180,
"reset": 1403602426
},
"/users/search": {
"limit": 180,
"remaining": 180,
"reset": 1403602426
},
"/users/contributors": {
"limit": 15,
"remaining": 15,
"reset": 1403602426
},
"/users/contributees": {
"limit": 15,
"remaining": 15,
"reset": 1403602426
},
"/users/suggestions/:slug": {
"limit": 15,
"remaining": 15,
"reset": 1403602426
}
},
"statuses": {
"/statuses/mentions_timeline": {
"limit": 15,
"remaining": 15,
"reset": 1403602426
},
"/statuses/lookup": {
"limit": 180,
"remaining": 180,
"reset": 1403602426
},
"/statuses/show/:id": {
"limit": 180,
"remaining": 180,
"reset": 1403602426
},
"/statuses/oembed": {
"limit": 180,
"remaining": 180,
"reset": 1403602426
},
"/statuses/retweeters/ids": {
"limit": 15,
"remaining": 15,
"reset": 1403602426
},
"/statuses/home_timeline": {
"limit": 15,
"remaining": 15,
"reset": 1403602426
},
"/statuses/user_timeline": {
"limit": 180,
"remaining": 180,
"reset": 1403602426
},
"/statuses/retweets/:id": {
"limit": 60,
"remaining": 60,
"reset": 1403602426
},
"/statuses/retweets_of_me": {
"limit": 15,
"remaining": 15,
"reset": 1403602426
}
},
"help": {
"/help/privacy": {
"limit": 15,
"remaining": 15,
"reset": 1403602426
},
"/help/tos": {
"limit": 15,
"remaining": 15,
"reset": 1403602426
},
"/help/configuration": {
"limit": 15,
"remaining": 15,
"reset": 1403602426
},
"/help/languages": {
"limit": 15,
"remaining": 15,
"reset": 1403602426
}
},
"search": {
"/search/tweets": {
"limit": 180,
"remaining": 180,
"reset": 1403602426
}
}
}
}