GET application/rate_limit_status
Returns the current rate limits for methods belonging to the specified resource families.
Each API resource belongs to a "resource family" which is indicated in its method documentation. The method's resource family can be determined 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 their 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, you should explicitly provide a
resources
parameter with the specified resource families
you work with.
When using application-only auth, this method's response indicates the application-only auth rate limiting context.
Read more about API Rate Limiting and review the limits.
Resource URL¶
https://api.x.com/1.1/application/rate_limit_status.json
Resource Information¶
Response formats | JSON |
Requires authentication? | Yes |
Rate limited? | Yes |
Requests / 15-min window (user auth) | 180 |
Requests / 15-min window (app auth) | 180 |
Parameters¶
Name | Required | Description | Default Value | Example |
---|---|---|---|---|
resources | optional | 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 API Rate Limiting for more information. |
|
Example Request¶
GET https://api.x.com/1.1/application/rate_limit_status.json?resources=help,users,search,statuses
Example Response¶
{
"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": 900,
"remaining": 900,
"reset": 1403602426
},
"/users/search": {
"limit": 900,
"remaining": 900,
"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": 75,
"remaining": 75,
"reset": 1403602426
},
"/statuses/lookup": {
"limit": 900,
"remaining": 900,
"reset": 1403602426
},
"/statuses/show/:id": {
"limit": 900,
"remaining": 900,
"reset": 1403602426
},
"/statuses/oembed": {
"limit": 180,
"remaining": 180,
"reset": 1403602426
},
"/statuses/retweeters/ids": {
"limit": 75,
"remaining": 75,
"reset": 1403602426
},
"/statuses/home_timeline": {
"limit": 15,
"remaining": 15,
"reset": 1403602426
},
"/statuses/user_timeline": {
"limit": 900,
"remaining": 900,
"reset": 1403602426
},
"/statuses/retweets/:id": {
"limit": 75,
"remaining": 75,
"reset": 1403602426
},
"/statuses/retweets_of_me": {
"limit": 75,
"remaining": 75,
"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
}
}
}
}