Get Web Data usage
curl --request GET \
--url https://api.floppydata.net/v2/web-data/usage \
--header 'X-Api-Key: <api-key>'import requests
url = "https://api.floppydata.net/v2/web-data/usage"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://api.floppydata.net/v2/web-data/usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"requests": {
"yesterday": {
"total": 3,
"successful": 2,
"failed": 1
},
"last7Days": {
"total": 30,
"successful": 28,
"failed": 2
},
"last30Days": {
"total": 120,
"successful": 112,
"failed": 8
},
"requestedRange": {
"total": 30,
"successful": 28,
"failed": 2
}
},
"lastUpdatedAt": "2026-06-10T12:00:00.000Z",
"filters": {
"from": "2025-01-27T00:00:00.000Z",
"to": "2025-12-28T23:59:59.999Z"
}
}{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters.",
"details": {
"issues": [
{
"path": "country",
"code": "invalid_format",
"message": "Expected a 2-letter country code."
}
]
}
}
}{
"error": {
"code": "unauthorized",
"message": "Unauthorized",
"details": {}
}
}{
"error": {
"code": "insufficient_balance",
"message": "Insufficient proxy traffic balance.",
"details": {}
}
}{
"error": {
"code": "forbidden",
"message": "Forbidden",
"details": {}
}
}{
"error": {
"code": "not_found",
"message": "Rotating proxy credential was not found.",
"details": {}
}
}{
"error": {
"code": "account_not_configured",
"message": "Account is not configured for proxy products.",
"details": {}
}
}{
"error": {
"code": "internal_error",
"message": "Internal Server Error",
"details": {}
}
}{
"error": {
"code": "upstream_error",
"message": "Failed to fetch data from an upstream service.",
"details": {
"upstreamStatus": 503
}
}
}Web Data
Usage
Returns Web Data API usage for the authenticated account as UTC period rollups: yesterday, last7Days, and last30Days. If from or to is supplied, the response also includes requestedRange. Use this for Web Data-only reporting.
GET
https://api.floppydata.net
/
v2
/
web-data
/
usage
Get Web Data usage
curl --request GET \
--url https://api.floppydata.net/v2/web-data/usage \
--header 'X-Api-Key: <api-key>'import requests
url = "https://api.floppydata.net/v2/web-data/usage"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://api.floppydata.net/v2/web-data/usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"requests": {
"yesterday": {
"total": 3,
"successful": 2,
"failed": 1
},
"last7Days": {
"total": 30,
"successful": 28,
"failed": 2
},
"last30Days": {
"total": 120,
"successful": 112,
"failed": 8
},
"requestedRange": {
"total": 30,
"successful": 28,
"failed": 2
}
},
"lastUpdatedAt": "2026-06-10T12:00:00.000Z",
"filters": {
"from": "2025-01-27T00:00:00.000Z",
"to": "2025-12-28T23:59:59.999Z"
}
}{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters.",
"details": {
"issues": [
{
"path": "country",
"code": "invalid_format",
"message": "Expected a 2-letter country code."
}
]
}
}
}{
"error": {
"code": "unauthorized",
"message": "Unauthorized",
"details": {}
}
}{
"error": {
"code": "insufficient_balance",
"message": "Insufficient proxy traffic balance.",
"details": {}
}
}{
"error": {
"code": "forbidden",
"message": "Forbidden",
"details": {}
}
}{
"error": {
"code": "not_found",
"message": "Rotating proxy credential was not found.",
"details": {}
}
}{
"error": {
"code": "account_not_configured",
"message": "Account is not configured for proxy products.",
"details": {}
}
}{
"error": {
"code": "internal_error",
"message": "Internal Server Error",
"details": {}
}
}{
"error": {
"code": "upstream_error",
"message": "Failed to fetch data from an upstream service.",
"details": {
"upstreamStatus": 503
}
}
}Authorizations
Client API key for the authenticated account.
Query Parameters
Start date or datetime in RFC 3339 format.
Pattern:
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$Example:
"2025-01-27T00:00:00Z"
End date or datetime in RFC 3339 format.
Pattern:
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$Example:
"2025-12-28"
Response
Web Data request usage.
UTC usage rollups. yesterday is the previous UTC calendar day; last7Days and last30Days are rolling windows ending at request time.
Show child attributes
Show child attributes
Most recent Web Data API request timestamp for the filters.
Example:
"2026-06-10T12:00:00.000Z"
Show child attributes
Show child attributes
Was this page helpful?