Skip to main content
GET
/
v2
/
usage
cURL
curl -X GET "https://api.getcatalog.ai/v2/usage?period=7d&page_size=5" \
  -H "x-api-key: $CATALOG_API_KEY"

{
  "data": [
    {
      "path": "/v1/listings",
      "total_calls": 9
    },
    {
      "path": "/v1/affiliate",
      "total_calls": 8
    },
    {
      "path": "/v1/vendors",
      "total_calls": 6
    },
    {
      "path": "/v1/agentic-search",
      "total_calls": 4
    },
    {
      "path": "/v1/collections",
      "total_calls": 4
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 5,
    "total_items": 16,
    "total_pages": 4,
    "has_next": true,
    "has_prev": false
  },
  "meta": {
    "period": "7d"
  }
}
When to use: Monitor your API consumption and track usage patterns. See Rate Limits for quota information.

​
Request

​
x-api-key
string
required
Your API key for authentication

​
Query Parameters

​
period
string
default:"30d"
Time period for usage statisticsValid Values:
  • 24h - Last 24 hours
  • 7d - Last 7 days
  • 30d - Last 30 days (default)
  • 90d - Last 90 days
  • all - All time usage
​
page
number
default:"1"
Page number for pagination (1-indexed)
​
page_size
number
default:"20"
Number of items per page (maximum 100)

​
Response

​
data
array
Array of usage statistics by endpoint path
​
pagination
object
Pagination metadata for the results
​
meta
object
Response metadata
cURL
curl -X GET "https://api.getcatalog.ai/v2/usage?period=7d&page_size=5" \
  -H "x-api-key: $CATALOG_API_KEY"

{
  "data": [
    {
      "path": "/v1/listings",
      "total_calls": 9
    },
    {
      "path": "/v1/affiliate",
      "total_calls": 8
    },
    {
      "path": "/v1/vendors",
      "total_calls": 6
    },
    {
      "path": "/v1/agentic-search",
      "total_calls": 4
    },
    {
      "path": "/v1/collections",
      "total_calls": 4
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 5,
    "total_items": 16,
    "total_pages": 4,
    "has_next": true,
    "has_prev": false
  },
  "meta": {
    "period": "7d"
  }
}