88API88API
User GuideAI ApplicationsAPI ReferenceHelp & Support
API Module Guide

Data Statistics Module

Feature Description

The API prefix is https://88api.ai

Usage statistics APIs for viewing the usage of your own account. Data is grouped by model and date and is used to generate charts and reports and follow usage trends.

🔐 User Authentication

My Usage Statistics by Date

  • Interface Name: My Usage Statistics by Date
  • HTTP Method: GET
  • Path: /api/data/self
  • Authentication Requirement: User
  • Description: Retrieves the current user's usage data aggregated by date, supporting time range queries.

💡 Request Example:

const response = await fetch('/api/data/self?start_timestamp=1640908800&end_timestamp=1640995200', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ Successful Response Example:

{
  "success": true,
  "message": "",
  "data": [
    {
      "model_name": "gpt-5.5",
      "count": 25,
      "quota": 12500,
      "token_used": 2000,
      "created_at": 1640995200,
      "user_id": 1,
      "username": "testuser"
    },
    {
      "model_name": "claude-sonnet-5-5",
      "count": 10,
      "quota": 30000,
      "token_used": 1500,
      "created_at": 1640995200,
      "user_id": 1,
      "username": "testuser"
    }
  ]
}

❗ Failure Response Example:

{
  "success": false,
  "message": "Failed to retrieve personal statistics data"
}

🧾 Field Description:

  • start_timestamp (Number): Start timestamp, optional
  • end_timestamp (Number): End timestamp, optional
  • data (Array): List of personal statistics data
    • model_name (String): Model name
    • count (Number): Request count
    • quota (Number): Quota consumption
    • token_used (Number): Token usage
    • created_at (Number): Statistics date timestamp
    • user_id (Number): User ID
    • username (String): Username