GET
/
usage
Get usage statistics
curl --request GET \
  --url https://api.vidnavigator.com/v1/usage \
  --header 'X-API-Key: <api-key>'
{
  "status": "success",
  "data": {
    "current_period": {
      "start_date": "2023-11-07T05:31:56Z",
      "end_date": "2023-11-07T05:31:56Z"
    },
    "subscription": {
      "plan_id": "<string>",
      "plan_name": "<string>"
    },
    "usage": {
      "video_transcripts": {
        "used": 123,
        "limit": 123,
        "remaining": 123,
        "percentage": 123,
        "unit": "<string>"
      },
      "video_searches": {
        "used": 123,
        "limit": 123,
        "remaining": 123,
        "percentage": 123,
        "unit": "<string>"
      },
      "video_analyses": {
        "used": 123,
        "limit": 123,
        "remaining": 123,
        "percentage": 123,
        "unit": "<string>"
      },
      "video_scene_analyses": {
        "used": 123,
        "limit": 123,
        "remaining": 123,
        "percentage": 123,
        "unit": "<string>"
      },
      "video_uploads": {
        "used": 123,
        "limit": 123,
        "remaining": 123,
        "percentage": 123,
        "unit": "<string>"
      }
    },
    "storage": {
      "used_bytes": 123,
      "used_formatted": "<string>",
      "limit_bytes": 123,
      "limit_formatted": "<string>",
      "remaining_bytes": 123,
      "remaining_formatted": "<string>",
      "percentage": 123
    }
  }
}
Retrieve your current API usage, including request counts for different endpoints and storage information.

​
Overview

This endpoint provides a snapshot of your current usage statistics, which is useful for monitoring your consumption and managing your limits.

​
Example Request

cURL
curl "https://api.vidnavigator.com/v1/usage" \
  -H "X-API-Key: YOUR_API_KEY"

​
Success Response (200 OK)

Returns an object containing detailed usage statistics for your account, broken down by service and storage. 
{
  "status": "success",
  "data": {
    "current_period": {
      "start_date": "2023-10-01T00:00:00Z",
      "end_date": "2023-11-01T00:00:00Z"
    },
    "subscription": {
      "plan_id": "pro",
      "plan_name": "Pro Plan"
    },
    "usage": {
      "video_transcripts": {
        "used": 150,
        "limit": 1000,
        "remaining": 850,
        "percentage": 15,
        "unit": "requests"
      },
      "video_searches": {
        "used": 300,
        "limit": 5000,
        "remaining": 4700,
        "percentage": 6,
        "unit": "requests"
      },
      "video_analyses": {
        "used": 75,
        "limit": "unlimited",
        "remaining": "unlimited",
        "percentage": 0,
        "unit": "requests"
      }
    },
    "storage": {
      "used_bytes": 2684354560,
      "used_formatted": "2.5 GB",
      "limit_bytes": 10737418240,
      "limit_formatted": "10 GB",
      "remaining_bytes": 8053063680,
      "remaining_formatted": "7.5 GB",
      "percentage": 25
    }
  }
}

Authorizations

​
X-API-Key
string
header
required

API key authentication. Include your VidNavigator API key in the X-API-Key header.

Response

200
application/json

Usage statistics retrieved successfully

The response is of type object.