---
title: "API analytics"
method: GET
path: "/v1/analytics"
tags: ["Account"]
---

# API analytics

`GET /v1/analytics`

## Request

- Base URL: `https://www.postquick.ai/api`
- URL: `https://www.postquick.ai/api/v1/analytics`
- Auth: HTTP bearer

Operational analytics for your own API usage: request volume, error rates, average response times, breakdowns by endpoint / status code / key, recent errors, a plain-words list of recent changes, and rate-limit meters. Read-only and scoped to the authenticated account. Accepts a pq_live_ API key or a dashboard session.

## Query parameters

- `period` '24h' | '7d' | '30d' | '90d': Analytics window. Default: 7d.

## Response `200`

Usage analytics for the requested window.

- object
  - `success` true, required
  - `data` object, required
    - `summary` object, required
      - `totalRequests` number, required
      - `successRate` number, required
      - `avgResponseTime` number, required
      - `uniqueEndpoints` number, required
      - `periodStart` string, required
      - `periodEnd` string, required
    - `requestsOverTime` object[], required
      - `date` string, required
      - `total` number, required
      - `success` number, required
      - `errors` number, required
    - `byEndpoint` object[], required
      - `endpoint` string, required
      - `count` number, required
      - `avgMs` number, required
      - `errorRate` number, required
    - `byStatusCode` object[], required
      - `code` number, required
      - `count` number, required
    - `byApiKey` object[], required
      - `keyId` string, required
      - `name` string, required
      - `count` number, required
      - `lastUsed` string, required
    - `recentErrors` object[], required
      - `endpoint` string, required
      - `status` number, required
      - `message` string, required
      - `at` string, required
    - `recentActivity` object[], required: Successful changes in plain words, newest first. One entry per key, action and day.
      - `by` string, required: The key or agent that made the requests.
      - `text` string, required: What it did, e.g. "Scheduled 3 videos".
      - `at` string, required: Most recent time it did so that day.
      - `count` number, required: How many times that day.
      - `details` object[], required: Up to 3 of the most recent items acted on, as they are now. Empty for deletes and deleted items.
        - `kind` 'post' | 'video' | 'story', required
        - `id` string, required
        - `title` string, required
        - `platforms` string[], required
        - `scheduledFor` string, nullable, required
        - `status` string, nullable, required
    - `rateLimitStatus` object, required
      - `plan` string, required
      - `minuteLimit` number, required
      - `minuteUsed` number, required
      - `dailyLimit` number, required
      - `dailyUsed` number, required

---

[API](https://skmtc.dev/postquick/apis/postquickai-api.md) · [All operations](https://skmtc.dev/postquick/apis/postquickai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/postquick/apis/postquickai-api/revisions/d9bc2bcf3042?raw)
