Get API usage metrics
Enterprise
The Usage API is a free REST API that provides programmatic access and visibility into activity consumption across products for your enterprise account. It is the most important and best tool for helping to monitor and manage usage across the different APIs under your account.
Important Disclaimer:
The usage counts returned from the Usage API may not match those on a billing invoice due to trials and other billing adjustments. All numbers are based on deduped activities consumed within a given day (in UTC).
Features
- Stream level usage data - provides usage data at the stream level (e.g., dev and prod) in addition to the product level
- Granular and descriptive data - search "requests" are broken out by Full-Archive and 30-Day Search products
- Historical PowerTrack “days” and “jobs” - (see payload snippet below)
"used": [
{
"activities": 11884,
"searchRequests30Day": 0,
"searchRequestsFullArchive": 0,
"historicalPowertrackDays": 5,
"historicalPowertrackJobs": 5,
"timePeriod": "201511010000"
},
Supported APIs
Below is a list of the APIs currently supported by the Usage API:
- PowerTrack API enterprise
- 30-Day Search API enterprise
- Full-Archive Search API enterprise
- Historical PowerTrack enterprise
Limitations
- The Usage API allows you to access usage data for the past 13 calendar months. For example, if it was the 10th of December, you can access usage data back to November 1st of the previous year.
- You have the ability to access usage data in three month intervals.
{
"account": {
"name": "gnip-username"
},
"bucket": "month",
"publishers": [
{
"type": "automattic",
"used": [
{
"activities": 0,
"timePeriod": "201603010000"
}
],
"projected": {
"activities": 0,
"timePeriod": "201603010000"
},
"products": [
{
"type": "PowerTrack",
"used": [
{
"timePeriod": "201603010000",
"activities": 0
}
],
"projected": {
"timePeriod": "201603010000",
"activities": 0
},
"endpoints": [
{
"type": "PowerTrack",
"label": "dev",
"used": [
{
"timePeriod": "201603010000",
"activities": 0
}
],
"projected": {
"timePeriod": "201603010000",
"activities": 0
}
}
]
}
]
},
{
"type": "twitter",
"used": [
{
"activities": 84,
"searchRequests30Day": 4,
"searchRequestsFullArchive": 0,
"historicalPowertrackDays": 0,
"historicalPowertrackJobs": 0,
"timePeriod": "201603010000"
}
],
"projected": {
"activities": 0,
"searchRequests30Day": 0,
"searchRequestsFullArchive": 0,
"historicalPowertrackDays": 0,
"historicalPowertrackJobs": 0,
"timePeriod": "201601010000"
},
"products": [
{
"type": "Historical PowerTrack Subscription",
"used": [
{
"timePeriod": "201511010000",
"activities": 11884,
"days": 5,
"jobs": 5
},
{
"timePeriod": "201512010000",
"activities": 0,
"days": 0,
"jobs": 0
},
{
"timePeriod": "201601010000",
"activities": 0,
"days": 0,
"jobs": 0
}
]
},
{
"type": "PowerTrack",
"used": [
{
"timePeriod": "201511010000",
"activities": 0
},
{
"timePeriod": "201512010000",
"activities": 27456
},
{
"timePeriod": "201601010000",
"activities": 0
}
],
"projected": {
"timePeriod": "201601010000",
"activities": 0
},
"endpoints": [
{
"type": "PowerTrack",
"label": "devel",
"used": [
{
"timePeriod": "201511010000",
"activities": 0
},
{
"timePeriod": "201512010000",
"activities": 2930
},
{
"timePeriod": "201601010000",
"activities": 0
}
],
"projected": {
"timePeriod": "201601010000",
"activities": 0
}
},
{
"type": "PowerTrack 2.0",
"label": "devel-v2",
"used": [
{
"timePeriod": "201511010000",
"activities": 0
},
{
"timePeriod": "201512010000",
"activities": 24542
},
{
"timePeriod": "201601010000",
"activities": 0
}
],
"projected": {
"timePeriod": "201601010000",
"activities": 0
}
},
{
"type": "PowerTrack 2.0",
"label": "devel-v2-1",
"used": [
{
"timePeriod": "201511010000",
"activities": 0
},
{
"timePeriod": "201512010000",
"activities": 0
},
{
"timePeriod": "201601010000",
"activities": 0
}
],
"projected": {
"timePeriod": "201601010000",
"activities": 0
}
}
]
},
{
"type": "Search API",
"used": [
{
"timePeriod": "201511010000",
"activities": 0,
"searchRequests30Day": 0
},
{
"timePeriod": "201512010000",
"activities": 0,
"searchRequests30Day": 0
},
{
"timePeriod": "201601010000",
"activities": 0,
"searchRequests30Day": 0
}
],
"projected": {
"timePeriod": "201601010000",
"activities": 0,
"searchRequests30Day": 0
},
"endpoints": [
{
"type": "Search API",
"label": "devel",
"used": [
{
"timePeriod": "201511010000",
"activities": 0,
"searchRequests30Day": 0
},
{
"timePeriod": "201512010000",
"activities": 0,
"searchRequests30Day": 0
},
{
"timePeriod": "201601010000",
"activities": 0,
"searchRequests30Day": 0
}
],
"projected": {
"timePeriod": "201601010000",
"activities": 0,
"searchRequests30Day": 0
}
}
]
},
{
"type": "Search API (30-Day)",
"used": [
{
"timePeriod": "201511010000",
"activities": 0,
"searchRequests30Day": 0
},
{
"timePeriod": "201512010000",
"activities": 0,
"searchRequests30Day": 0
},
{
"timePeriod": "201601010000",
"activities": 0,
"searchRequests30Day": 0
}
],
"projected": {
"timePeriod": "201601010000",
"activities": 0,
"searchRequests30Day": 0
},
"endpoints": [
{
"type": "Search API (30-Day)",
"label": "devel",
"used": [
{
"timePeriod": "201511010000",
"activities": 0,
"searchRequests30Day": 0
},
{
"timePeriod": "201512010000",
"activities": 0,
"searchRequests30Day": 0
},
{
"timePeriod": "201601010000",
"activities": 0,
"searchRequests30Day": 0
}
],
"projected": {
"timePeriod": "201601010000",
"activities": 0,
"searchRequests30Day": 0
}
}
]
},
{
"type": "Search API (Full-Archive)",
"used": [
{
"timePeriod": "201511010000",
"activities": 0,
"searchRequestsFullArchive": 0
},
{
"timePeriod": "201512010000",
"activities": 0,
"searchRequestsFullArchive": 0
},
{
"timePeriod": "201601010000",
"activities": 0,
"searchRequestsFullArchive": 0
}
],
"projected": {
"timePeriod": "201601010000",
"activities": 0,
"searchRequestsFullArchive": 0
},
"endpoints": [
{
"type": "Search API (Full-Archive)",
"label": "devel",
"used": [
{
"timePeriod": "201511010000",
"activities": 0,
"searchRequestsFullArchive": 0
},
{
"timePeriod": "201512010000",
"activities": 0,
"searchRequestsFullArchive": 0
},
{
"timePeriod": "201601010000",
"activities": 0,
"searchRequestsFullArchive": 0
}
],
"projected": {
"timePeriod": "201601010000",
"activities": 0,
"searchRequestsFullArchive": 0
}
}
]
}
]
}
]
}