Get API Usage Statistics

Retrieve API usage statistics for your account grouped by endpoint path

Get detailed usage analytics for your API key showing request counts grouped by endpoint path. This endpoint provides insight into your API consumption patterns with configurable time periods.

Request

x-api-key · string · required

Your API key for authentication

Query Parameters

period · string · default: "30d"

Time period for usage statistics

Valid Values:

• 24h - Last 24 hours
• 7d - Last 7 days
• 30d - Last 30 days (default)
• 90d - Last 90 days
• all - All time usage

Response

usage · array

Array of usage statistics by endpoint path

Show Usage Statistics

path · string

API endpoint path (e.g., “/api/search”, “/api/product”)

total_calls · number

Total number of API calls made to this endpoint

period · string

Echo back the requested time period

cURL

curl -X GET "https://api.getcatalog.ai/api/usage?period=7d" \
  -H "x-api-key: YOUR_API_KEY"

Success Response

{
  "usage": [
    {
      "path": "/api/search",
      "total_calls": 1247
    },
    {
      "path": "/api/product",
      "total_calls": 856
    },
    {
      "path": "/api/products",
      "total_calls": 234
    },
    {
      "path": "/v1/affiliate",
      "total_calls": 89
    },
    {
      "path": "/api/feed",
      "total_calls": 45
    }
  ],
  "period": "7d"
}