{
"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>'
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Floppydata Client API","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/floppydata/t-In33JhdHge9jll/logo/light.svg?fit=max\u0026auto=format\u0026n=t-In33JhdHge9jll\u0026q=85\u0026s=2b3535dc315190c13602ee83ea3378c2","dark":"https://mintcdn.com/floppydata/t-In33JhdHge9jll/logo/dark.svg?fit=max\u0026auto=format\u0026n=t-In33JhdHge9jll\u0026q=85\u0026s=0f73f0b83947c39a68c2b0167841ab91"},"favicon":"https://mintcdn.com/floppydata/7MGx7VQNZ_E0n9Af/favicon.svg?fit=max\u0026auto=format\u0026n=7MGx7VQNZ_E0n9Af\u0026q=85\u0026s=eb959f0fd197b23eaa20c112427e3ede","api":{"openapi":["api-reference/openapi.json","api-reference/openapi-v1.json"],"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript"],"prefill":true},"url":"full"},"navbar":{"links":[{"href":"https://app.floppydata.com","label":"Dashboard"}],"primary":{"type":"button","label":"Get API key","href":"https://app.floppydata.com/api-keys"}},"footer":{"socials":{"github":"https://github.com/Floppydata/floppydata-docs"}},"contextual":{"options":["copy","view"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"floppydata","hasAudioNarration":false,"actualSubdomain":"floppydata","customDomains":["floppydata.com"],"gitSource":{"type":"github","owner":"floppydata","repo":"floppydata-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"issues":false,"edits":false},"entitlements":{},"buildId":"6acf3140c1c56b6740ebd9ed","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"API Reference","count":22},{"language":"default","tag":"V2","count":22},{"language":"default","tag":"Proxy","count":9},{"language":"default","tag":"Guides","count":9},{"language":"default","tag":"Cloud Browser","count":7},{"language":"default","tag":"Rotating","count":7},{"language":"default","tag":"Start","count":6},{"language":"default","tag":"Core API tasks","count":6},{"language":"default","tag":"Web Data","count":4},{"language":"default","tag":"Proxy setup","count":3}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/v2/endpoint/web-data-usage","slug":"/api-reference/v2/endpoint/web-data-usage","pageMetadata":{"title":"Usage","openapi":"api-reference/openapi.json GET /v2/web-data/usage","description":"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.","href":"/api-reference/v2/endpoint/web-data-usage"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"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.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Usage","openapi":"api-reference/openapi.json GET /v2/web-data/usage","description":"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.","href":"/api-reference/v2/endpoint/web-data-usage"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getWebDataUsage","summary":"Get Web Data usage","description":"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.","tags":["Web Data"],"responses":{"200":"f6c263aa-66d5-4d7f-bb2a-b7ce2b8d57ef","400":"07d8ecca-a02e-448f-ab70-fd38794bc4be","401":"2a74d93c-9d78-4861-97e1-9df009189265","402":"18a6829c-06dc-44c8-ad74-0c4068bd522a","403":"b728d77e-edf2-43f9-99b3-328460b7d830","404":"73cc965f-591f-4879-ba12-f18b3ab75289","409":"52629987-57b0-4a07-9542-1269f5706ea3","500":"703be1eb-44ac-4cd6-b680-85ce998f5140","502":"26c8a3ba-7ee6-439f-9158-0bb3784015cc"},"parameters":["aa8c9102-bfd5-49ab-8257-de8755197ad6","0b853478-5ead-40ba-b9f9-e2c36a62f5c7"],"method":"get","type":"path","servers":["5a416e7f-7912-470a-86f6-f1cfb9117df7"],"security":["af1e0e9b-cfa3-42c1-ab39-d4abb4facf41"],"path":"/v2/web-data/usage","baseUrlOptions":["https://api.floppydata.net"],"title":"Get Web Data usage","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[],"urlDisplay":"full"},"dependencies":{"parameters":{"aa8c9102-bfd5-49ab-8257-de8755197ad6":{"in":"query","name":"from","schema":{"oneOf":[{"type":"string","format":"date","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","description":"Start date or datetime in RFC 3339 format.","uniqueKey":"oneOf.0","typeLabel":"string\u003cdate>"},{"type":"string","format":"date-time","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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","example":"2025-01-27T00:00:00Z","description":"Start date or datetime in RFC 3339 format.","uniqueKey":"oneOf.1","typeLabel":"string\u003cdate-time>"}],"uniqueKey":"","typeLabel":"string\u003cdate> | string\u003cdate-time>"},"description":"Start date or datetime in RFC 3339 format."},"0b853478-5ead-40ba-b9f9-e2c36a62f5c7":{"in":"query","name":"to","schema":{"oneOf":[{"type":"string","format":"date","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","description":"End date or datetime in RFC 3339 format.","uniqueKey":"oneOf.0","typeLabel":"string\u003cdate>"},{"type":"string","format":"date-time","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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","example":"2025-12-28","description":"End date or datetime in RFC 3339 format.","uniqueKey":"oneOf.1","typeLabel":"string\u003cdate-time>"}],"uniqueKey":"","typeLabel":"string\u003cdate> | string\u003cdate-time>"},"description":"End date or datetime in RFC 3339 format."}},"responses":{"f6c263aa-66d5-4d7f-bb2a-b7ce2b8d57ef":{"description":"Web Data request usage.","content":{"application/json":{"schema":{"type":"object","properties":{"requests":{"type":"object","properties":{"yesterday":{"type":"object","properties":{"total":{"type":"integer","minimum":0,"maximum":9007199254740991,"example":30,"isRequired":true,"uniqueKey":"requests.yesterday.total","typeLabel":"integer"},"successful":{"type":"integer","minimum":0,"maximum":9007199254740991,"example":28,"isRequired":true,"uniqueKey":"requests.yesterday.successful","typeLabel":"integer"},"failed":{"type":"integer","minimum":0,"maximum":9007199254740991,"example":2,"isRequired":true,"uniqueKey":"requests.yesterday.failed","typeLabel":"integer"}},"required":["total","successful","failed"],"isRequired":true,"uniqueKey":"requests.yesterday","typeLabel":"object"},"last7Days":{"type":"object","properties":{"total":{"type":"integer","minimum":0,"maximum":9007199254740991,"example":30,"isRequired":true,"uniqueKey":"requests.last7Days.total","typeLabel":"integer"},"successful":{"type":"integer","minimum":0,"maximum":9007199254740991,"example":28,"isRequired":true,"uniqueKey":"requests.last7Days.successful","typeLabel":"integer"},"failed":{"type":"integer","minimum":0,"maximum":9007199254740991,"example":2,"isRequired":true,"uniqueKey":"requests.last7Days.failed","typeLabel":"integer"}},"required":["total","successful","failed"],"isRequired":true,"uniqueKey":"requests.last7Days","typeLabel":"object"},"last30Days":{"type":"object","properties":{"total":{"type":"integer","minimum":0,"maximum":9007199254740991,"example":30,"isRequired":true,"uniqueKey":"requests.last30Days.total","typeLabel":"integer"},"successful":{"type":"integer","minimum":0,"maximum":9007199254740991,"example":28,"isRequired":true,"uniqueKey":"requests.last30Days.successful","typeLabel":"integer"},"failed":{"type":"integer","minimum":0,"maximum":9007199254740991,"example":2,"isRequired":true,"uniqueKey":"requests.last30Days.failed","typeLabel":"integer"}},"required":["total","successful","failed"],"isRequired":true,"uniqueKey":"requests.last30Days","typeLabel":"object"},"requestedRange":{"description":"Usage for the requested from/to range. Present only when from or to is supplied.","type":"object","properties":{"total":{"type":"integer","minimum":0,"maximum":9007199254740991,"example":30,"isRequired":true,"uniqueKey":"requests.requestedRange.total","typeLabel":"integer"},"successful":{"type":"integer","minimum":0,"maximum":9007199254740991,"example":28,"isRequired":true,"uniqueKey":"requests.requestedRange.successful","typeLabel":"integer"},"failed":{"type":"integer","minimum":0,"maximum":9007199254740991,"example":2,"isRequired":true,"uniqueKey":"requests.requestedRange.failed","typeLabel":"integer"}},"required":["total","successful","failed"],"uniqueKey":"requests.requestedRange","typeLabel":"object"}},"required":["yesterday","last7Days","last30Days"],"description":"UTC usage rollups. yesterday is the previous UTC calendar day; last7Days and last30Days are rolling windows ending at request time.","isRequired":true,"uniqueKey":"requests","typeLabel":"object"},"lastUpdatedAt":{"oneOf":[{"type":"string","description":"Most recent Web Data API request timestamp for the filters.","example":"2026-06-10T12:00:00.000Z","isRequired":true,"uniqueKey":"lastUpdatedAt.oneOf.0","typeLabel":"string"},{"type":"null","description":"Most recent Web Data API request timestamp for the filters.","example":"2026-06-10T12:00:00.000Z","isRequired":true,"uniqueKey":"lastUpdatedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"lastUpdatedAt","typeLabel":"string | null"},"filters":{"type":"object","properties":{"from":{"example":"2025-01-27T00:00:00.000Z","type":"string","uniqueKey":"filters.from","typeLabel":"string"},"to":{"example":"2025-12-28T23:59:59.999Z","type":"string","uniqueKey":"filters.to","typeLabel":"string"}},"isRequired":true,"uniqueKey":"filters","typeLabel":"object"}},"required":["requests","lastUpdatedAt","filters"],"uniqueKey":"","typeLabel":"object"},"example":{"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"}},"examples":{"Example":{"title":"Example","value":{"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"}}}},"exampleType":"examples"}},"exampleType":"examples"},"07d8ecca-a02e-448f-ab70-fd38794bc4be":{"description":"The request body or query parameters are invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"invalid_request","message":"Invalid request parameters.","details":{"issues":[{"path":"country","code":"invalid_format","message":"Expected a 2-letter country code."}]}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"Invalid request parameters.","details":{"issues":[{"path":"country","code":"invalid_format","message":"Expected a 2-letter country code."}]}}}}},"exampleType":"examples"}},"exampleType":"examples"},"2a74d93c-9d78-4861-97e1-9df009189265":{"description":"The API key is missing, invalid, or expired.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"unauthorized","message":"Unauthorized","details":{}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthorized","message":"Unauthorized","details":{}}}}},"exampleType":"examples"}},"exampleType":"examples"},"18a6829c-06dc-44c8-ad74-0c4068bd522a":{"description":"The account does not have enough balance for this request.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"insufficient_balance","message":"Insufficient proxy traffic balance.","details":{}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"insufficient_balance","message":"Insufficient proxy traffic balance.","details":{}}}}},"exampleType":"examples"}},"exampleType":"examples"},"b728d77e-edf2-43f9-99b3-328460b7d830":{"description":"The API key does not grant access to this operation.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"forbidden","message":"Forbidden","details":{}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"forbidden","message":"Forbidden","details":{}}}}},"exampleType":"examples"}},"exampleType":"examples"},"73cc965f-591f-4879-ba12-f18b3ab75289":{"description":"The requested resource is not available.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"not_found","message":"Rotating proxy credential was not found.","details":{}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"not_found","message":"Rotating proxy credential was not found.","details":{}}}}},"exampleType":"examples"}},"exampleType":"examples"},"52629987-57b0-4a07-9542-1269f5706ea3":{"description":"The authenticated account is not configured for this product.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"account_not_configured","message":"Account is not configured for proxy products.","details":{}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"account_not_configured","message":"Account is not configured for proxy products.","details":{}}}}},"exampleType":"examples"}},"exampleType":"examples"},"703be1eb-44ac-4cd6-b680-85ce998f5140":{"description":"An unexpected server error occurred.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"internal_error","message":"Internal Server Error","details":{}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"internal_error","message":"Internal Server Error","details":{}}}}},"exampleType":"examples"}},"exampleType":"examples"},"26c8a3ba-7ee6-439f-9158-0bb3784015cc":{"description":"An upstream service failed while processing the request.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"upstream_error","message":"Failed to fetch data from an upstream service.","details":{"upstreamStatus":503}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"upstream_error","message":"Failed to fetch data from an upstream service.","details":{"upstreamStatus":503}}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"af1e0e9b-cfa3-42c1-ab39-d4abb4facf41":{"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"Client API key for the authenticated account.","scopes":[]}}},"servers":{"5a416e7f-7912-470a-86f6-f1cfb9117df7":{"url":"https://api.floppydata.net","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"Client API key for the authenticated account.","scopes":[]},"schema":{"title":"X-Api-Key","type":"string","description":"Client API key for the authenticated account.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyHeader","name":"X-Api-Key"}],"title":"apiKeyHeader"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"floppydata","siteName":"Floppydata Client API","title":"Usage - Floppydata Client API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-26T13:58:07.473Z","originalFileLocation":"api-reference/v2/endpoint/web-data-usage.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"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.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Floppydata Client API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/floppydata/JO5OYhPSPV8YsrHU/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/floppydata/JO5OYhPSPV8YsrHU/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/floppydata/JO5OYhPSPV8YsrHU/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/floppydata/JO5OYhPSPV8YsrHU/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/floppydata/JO5OYhPSPV8YsrHU/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/floppydata/JO5OYhPSPV8YsrHU/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/floppydata/JO5OYhPSPV8YsrHU/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/floppydata/JO5OYhPSPV8YsrHU/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/floppydata/JO5OYhPSPV8YsrHU/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Usage - Floppydata Client API\">\u003cmeta data-mint-head property=\"og:description\" content=\"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.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Floppydata Client API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://floppydata.com/docs/api-reference/v2/endpoint/web-data-usage\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://floppydata.mintlify.site/docs/_mintlify/api/og/v2?division=Web+Data\u0026amp;title=Usage\u0026amp;description=Returns+Web+Data+API+usage+for+the+authenticated+account+as+UTC+period+rollups%3A+yesterday%2C+last7Days%2C+and+last30Days.+If+from+or+to+is+supplied%2C+the+response+al\u0026amp;theme=1fa247ce104f288b8b83ea72\u0026amp;signature=98b6b4384266e49ecbfceb5f921859c4d8e954b79255022fed522291ec68bdfe\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Usage - Floppydata Client API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"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.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://floppydata.mintlify.site/docs/_mintlify/api/og/v2?division=Web+Data\u0026amp;title=Usage\u0026amp;description=Returns+Web+Data+API+usage+for+the+authenticated+account+as+UTC+period+rollups%3A+yesterday%2C+last7Days%2C+and+last30Days.+If+from+or+to+is+supplied%2C+the+response+al\u0026amp;theme=1fa247ce104f288b8b83ea72\u0026amp;signature=98b6b4384266e49ecbfceb5f921859c4d8e954b79255022fed522291ec68bdfe\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/floppydata/JO5OYhPSPV8YsrHU/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Floppydata Client API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://floppydata.com/docs/api-reference/v2/endpoint/web-data-usage\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/v2/endpoint/web-data-usage.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://floppydata.com/#organization\",\"name\":\"Floppydata Client API\",\"url\":\"https://floppydata.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/floppydata/t-In33JhdHge9jll/logo/light.svg?fit=max\u0026auto=format\u0026n=t-In33JhdHge9jll\u0026q=85\u0026s=2b3535dc315190c13602ee83ea3378c2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://floppydata.com/docs#website\",\"name\":\"Floppydata Client API\",\"url\":\"https://floppydata.com/docs\",\"publisher\":{\"@id\":\"https://floppydata.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://floppydata.com/docs/api-reference/v2/endpoint/web-data-usage#webpage\",\"url\":\"https://floppydata.com/docs/api-reference/v2/endpoint/web-data-usage\",\"name\":\"Usage\",\"description\":\"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.\",\"dateModified\":\"2026-06-26T13:58:07.473Z\",\"isPartOf\":{\"@id\":\"https://floppydata.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://floppydata.com/docs/api-reference/v2/endpoint/web-data-usage#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://floppydata.com/docs/api-reference/v2/endpoint/web-data-usage#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"V2\",\"item\":\"https://floppydata.com/docs/api-reference/v2/endpoint/web-data-search\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Web Data\",\"item\":\"https://floppydata.com/docs/api-reference/v2/endpoint/web-data-search\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Usage\",\"item\":\"https://floppydata.com/docs/api-reference/v2/endpoint/web-data-usage\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://floppydata.com/docs/api-reference/v2/endpoint/web-data-usage#apireference\",\"headline\":\"Usage\",\"name\":\"Usage\",\"description\":\"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.\",\"url\":\"https://floppydata.com/docs/api-reference/v2/endpoint/web-data-usage\",\"mainEntityOfPage\":{\"@id\":\"https://floppydata.com/docs/api-reference/v2/endpoint/web-data-usage#webpage\"},\"dateModified\":\"2026-06-26T13:58:07.473Z\",\"publisher\":{\"@id\":\"https://floppydata.com/#organization\"},\"isPartOf\":{\"@id\":\"https://floppydata.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Floppydata Client API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Floppydata Client API","nav":{"global":null,"tabs":[{"tab":"Start","pages":[{"title":"Start","href":"/overview"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/web-data"}]},{"tab":"API Reference","groups":[{"group":"Overview","root":{"title":"API Reference","href":"/api-reference/introduction"},"pages":[]},{"group":"V2","pages":[{"group":"Web Data","expanded":true,"pages":[{"title":"Search","openapi":"api-reference/openapi.json POST /v2/web-data/search","href":"/api-reference/v2/endpoint/web-data-search"},{"title":"Fetch","openapi":"api-reference/openapi.json POST /v2/web-data/fetch","href":"/api-reference/v2/endpoint/web-data-fetch"},{"title":"Balance","openapi":"api-reference/openapi.json GET /v2/web-data/balance","description":"Returns the authenticated account balance for Web Data requests only. Use getAccountBalances for an account-level rollup across products.","href":"/api-reference/v2/endpoint/web-data-balance"},{"title":"Usage","openapi":"api-reference/openapi.json GET /v2/web-data/usage","href":"/api-reference/v2/endpoint/web-data-usage"}]},{"group":"Cloud Browser","expanded":true,"pages":[{"title":"Create a Session","openapi":"api-reference/openapi.json POST /v2/browser/sessions","description":"Creates and starts a browser. The smallest request is {}. Add startUrl to open one or more pages at launch, or navigate with Playwright or Puppeteer after connecting. Supply startUrl as one string of absolute HTTP or HTTPS URLs separated by commas without spaces, up to 2,048 characters total. Omit startUrl when supplying settings.id. Use the returned WebSocket URL to connect, select the tab by URL, and wait for the page content you need.","href":"/api-reference/v2/endpoint/browser-session-create"},{"title":"Connect to a Session","openapi":"api-reference/openapi.json GET /v2/browser/sessions/{sessionId}/connect","href":"/api-reference/v2/endpoint/browser-session-connect"},{"title":"Get a Session","openapi":"api-reference/openapi.json GET /v2/browser/sessions/{sessionId}","href":"/api-reference/v2/endpoint/browser-session-get"},{"title":"List Sessions","openapi":"api-reference/openapi.json GET /v2/browser/sessions","href":"/api-reference/v2/endpoint/browser-session-list"},{"title":"Create a Live View","openapi":"api-reference/openapi.json POST /v2/browser/sessions/{sessionId}/live-view","href":"/api-reference/v2/endpoint/browser-session-live-view"},{"title":"Stop a Session","openapi":"api-reference/openapi.json POST /v2/browser/sessions/{sessionId}/stop","href":"/api-reference/v2/endpoint/browser-session-stop"},{"title":"Delete Saved Settings","openapi":"api-reference/openapi.json DELETE /v2/browser/settings/{settingsId}","href":"/api-reference/v2/endpoint/browser-settings-delete"}]},{"group":"Proxy","expanded":true,"pages":[{"group":"Rotating","expanded":true,"pages":[{"title":"Connections","openapi":"api-reference/openapi.json POST /v2/proxy/rotating/connections","href":"/api-reference/v2/endpoint/rotating-connection"},{"title":"List Subusers","openapi":"api-reference/openapi.json GET /v2/proxy/rotating/subusers","href":"/api-reference/v2/endpoint/rotating-subusers-list"},{"title":"Create a Subuser","openapi":"api-reference/openapi.json POST /v2/proxy/rotating/subusers","href":"/api-reference/v2/endpoint/rotating-subusers-create"},{"title":"Delete a Subuser","openapi":"api-reference/openapi.json DELETE /v2/proxy/rotating/subusers/{subuserId}","href":"/api-reference/v2/endpoint/rotating-subusers-delete"},{"title":"Locations","openapi":"api-reference/openapi.json GET /v2/proxy/rotating/locations","href":"/api-reference/v2/endpoint/rotating-locations"},{"title":"Balance","openapi":"api-reference/openapi.json GET /v2/proxy/rotating/balance","href":"/api-reference/v2/endpoint/rotating-balance"},{"title":"Usage","openapi":"api-reference/openapi.json GET /v2/proxy/rotating/usage","href":"/api-reference/v2/endpoint/rotating-usage"}]},{"group":"Static","expanded":true,"pages":[{"title":"List Proxies","openapi":"api-reference/openapi.json GET /v2/proxy/static","href":"/api-reference/v2/endpoint/static-proxies"}]},{"title":"Check Proxy","openapi":"api-reference/openapi.json POST /v2/proxy/check","href":"/api-reference/v2/endpoint/check-proxy"}]},{"group":"Account","expanded":true,"pages":[{"title":"Balances","openapi":"api-reference/openapi.json GET /v2/account/balances","href":"/api-reference/v2/endpoint/account-balances"},{"title":"Usage","openapi":"api-reference/openapi.json GET /v2/account/usage","href":"/api-reference/v2/endpoint/account-usage"}]}]}]},{"tab":"Legacy v1","pages":[{"title":"Legacy v1","href":"/legacy-v1"}]}]},"basePath":"","title":"Usage - Floppydata Client API","buildId":"dpl_6dVqRXFR2Go5vF5RLvAdHuv189oT","deploymentId":"dpl_6dVqRXFR2Go5vF5RLvAdHuv189oT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-D_7my4bd.js","utils-Cq_itTNA.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B5KPEvGz.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DBX-JepP.js","snippetPresets-Bsspz-Ge.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-jcs-2nGf.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Dp53in7F.js","shallow-Dv9eUdUd.js","getApiPlaygroundDisplay-D8cDwNhi.js","CodeSnippet-DkwXLQor.js","CodeSnippets-DcSgKqs5.js","Page-t8ynOKTD.js","getPastedJson-I2RjoApV.js","icon-BIj57rZC.js","MethodPill-CTwLPWXC.js","DuplicateIcon-BJpFwygY.js","createIcon-C7PorfAe.js","DynamicMarkdown-BBht_uEs.js","SectionHeading-YIBwxbzj.js","axios-vUo_bRtp.js","Markdown--YCeFtOs.js","clsx-CrPa459s.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BWxsj3I0.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fBzVvq7k.js"]}