Accounts
Get account activity
Returns account usage, billing estimate, pricing, and recommended next actions for the authenticated account.
get/v1/account/activity
Response
Account activity loaded.
Example response
{
"profile": {
"accountId": "acct_123",
"email": "user@example.com",
"provider": "google",
"plan": "pro",
"displayName": null
},
"usage": {
"meters": {
"hour": {},
"day": {},
"week": {},
"twoWeeks": {},
"month": {
"scraper.tiktok.result_records": 1000,
"scraper.tiktok.cost_usd_micros": 1700000
},
"quarter": {}
}
},
"pricing": {
"subscriptionUsdCentsPerMonth": 2000,
"planBalanceUsdCentsPerMonth": 2000,
"bonusBalanceUsdCentsPerMonth": 0,
"includedBalanceUsdCentsPerMonth": 2000,
"paidOveragesEnabled": false
},
"billingEstimate": {
"currency": "USD",
"plan": "plus",
"paidOveragesEnabled": false,
"subscriptionUsdMicrosPerMonth": 20000000,
"planBalanceUsdCentsPerMonth": 2000,
"bonusBalanceUsdCentsPerMonth": 0,
"includedBalanceUsdCentsPerMonth": 2000,
"topUpBalanceUsdMicros": 0,
"topUpMinimumUsdCents": 2000,
"topUpMaximumUsdCents": 100000,
"topUpExpiresAfterInactiveDays": 365,
"autoTopUpEnabled": false,
"autoTopUpThresholdUsdCents": 500,
"autoTopUpAmountUsdCents": 2000,
"autoTopUpMonthlyLimitUsdCents": 100000,
"currentMonthBonusBalanceUsedUsdMicros": 0,
"currentMonthPlanBalanceUsedUsdMicros": 1700000,
"currentMonthTopUpBalanceUsedUsdMicros": 0,
"currentMonthOverageUsdMicros": 0,
"estimatedMonthlyTotalUsdMicros": 20000000,
"lineItems": [
{
"product": "tiktok",
"meter": "scraper_result_records",
"currentMonthUsed": 1000,
"includedPerMonth": null,
"billableAmount": 1000,
"usageUnit": "result",
"billingUnit": "result",
"billingUnitSize": 1,
"priceUsdMicrosPerBillingUnit": null,
"estimatedUsdMicros": 1700000,
"estimateBasis": "stored_scrape_requests",
"rounding": "actual_scraper_cost"
}
],
"nextActions": [
"plus scraper usage is within monthly balance. Bonus balance is spent before paid plan balance.",
"Fetch saved results or create another public-data scraper request when you need fresh data."
]
},
"nextActions": [
"Run `tovuk request results <request-id> --json` to fetch stored results.",
"Run `tovuk scraper list --json` before creating another paid scraper request."
]
}