Query Usage Statistics

January 31, 2026

Table of contents

  1. Request Headers
  2. Query Parameters
  3. Responses
  4. Model
  5. Examples
  6. Try It

Query your API usage statistics. Returns detailed information about jobs/requests for a specific bot.

Note:

  • Data latency is at least 5 minutes, but should not exceed 15 minutes.
  • Data is retained for 3 months.

https://api.useapi.net/v2/account/stats

Request Headers 
Authorization: Bearer {API token}
Query Parameters
Parameter Required Description
bot Yes Bot to query stats for.
Supported: midjourney, google-flow, kling, runwayml, pixverse, minimax, mureka, tempolor, ltxstudio
date No Date in YYYY-MM-DD format.
Defaults to today if limit is not specified.
limit No Number of records to return (max: 50000).
If specified, date filter is ignored and returns last N records across all dates.
config No Filter by specific config (channel/email/account depending on bot).
Responses

  • 200 OK

    Returns usage statistics for the specified bot.

    {
  "bot": "google-flow",
  "date": "2026-01-31",
  "total": 42,
  "summary": {
    "from": "2026-01-31T00:05:23.000Z",
    "to": "2026-01-31T23:58:47.000Z",
    "time_span": "23 hours 53 minutes",
    "by_config": {
      "[email protected]": 42
    },
    "by_code": {
      "200": 35,
      "403": 7
    },
    "by_endpoint": {
      "images": 30,
      "videos": 12
    },
    "by_status": {
      "completed": 35,
      "failed": 7
    },
    "success_rate": "83.3%",
    "avg_msec": 4523,
    "by_captcha_provider": {
      "2captcha": 25,
      "capsolver": 17
    },
    "avg_captcha_retry": 1.2
  },
  "data": [
    {
      "timestamp": "2026-01-31T10:30:00.000Z",
      "jobid": "20260131103000123-user:123-bot:google-flow",
      "config": "[email protected]",
      "endpoint": "images",
      "status": "completed",
      "func": "v1-google-flow-images",
      "code": 200,
      "msec": 5432,
      "captchaProviders": "2captcha",
      "captchaRetry": 1
    }
  ]
}

    The summary object provides aggregated statistics (omitted if no data).

    For google-flow, additional fields are included in both data rows and summary:

    • captchaProviders / by_captcha_provider: Captcha providers used
    • captchaRetry / avg_captcha_retry: Captcha retry attempts

  • 400 Bad Request

    Missing or invalid parameters.

    {
  "error": "<error message>"
}

  • 401 Unauthorized

    Invalid API token.

    {
  "error": "Unauthorized"
}
Model 
// Response structure
{
  bot: string                    // Bot name
  date?: string                  // Date filter applied (YYYY-MM-DD)
  limit?: number                 // Limit filter applied
  config?: string                // Config filter applied
  total: number                  // Total records returned
  summary?: {                    // Aggregated statistics (omitted if no data)
    from: string                 // Earliest timestamp (ISO 8601)
    to: string                   // Latest timestamp (ISO 8601)
    time_span: string            // Human readable duration (e.g., "2 days 5 hours")
    by_config: Record<string, number>    // Count per config/account
    by_code: Record<string, number>      // Count per HTTP status code
    by_endpoint: Record<string, number>  // Count per endpoint/verb
    by_status: Record<string, number>    // Count per job status
    success_rate: string         // Percentage of 2xx codes (e.g., "86.7%")
    avg_msec: number             // Average response time in ms
    // google-flow only:
    by_captcha_provider?: Record<string, number>  // Count per captcha provider
    avg_captcha_retry?: number   // Average captcha retries
  }
  data: Array<{
    timestamp: string            // ISO 8601 timestamp
    jobid: string                // Job/task identifier
    config: string               // Account/config used (channel for MJ, email/account for others)
    endpoint: string             // API endpoint called
    status: string               // Job status
    func: string                 // Function name
    code: number                 // HTTP status code
    msec: number                 // Duration in milliseconds
    // google-flow only:
    captchaProviders?: string    // Captcha providers tried (comma-separated)
    captchaRetry?: number        // Number of captcha retries
  }>
}
Examples 
  • # Today's stats for midjourney
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
     "https://api.useapi.net/v2/account/stats?bot=midjourney"

# Specific date
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
     "https://api.useapi.net/v2/account/stats?bot=google-flow&date=2026-01-31"

# Last 1000 records
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
     "https://api.useapi.net/v2/account/stats?bot=kling&limit=1000"

# Filter by config
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
     "https://api.useapi.net/v2/account/stats?bot=runwayml&[email protected]"

  • const token = 'YOUR_API_TOKEN';
const bot = 'google-flow';
const date = '2026-01-31';

const response = await fetch(
  `https://api.useapi.net/v2/account/stats?bot=${bot}&date=${date}`,
  {
    headers: {
      'Authorization': `Bearer ${token}`
    }
  }
);

const stats = await response.json();
console.log(`Total records: ${stats.total}`);
console.log('Stats:', stats.data);

  • import requests

token = 'YOUR_API_TOKEN'
headers = {'Authorization': f'Bearer {token}'}

# Today's stats for midjourney
response = requests.get(
    'https://api.useapi.net/v2/account/stats',
    params={'bot': 'midjourney'},
    headers=headers
)
stats = response.json()
print(f"Total records: {stats['total']}")
print('Stats:', stats['data'])
Try It