v50

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-07-112650216.3 KB
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.

nextActionsstring[] required

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."
  ]
}