PostGrad
API Reference

Get knowledge base statistics

View as Markdown

Returns high-level statistics about the knowledge base including total entries, number of categories, and last updated timestamp. This is a public endpoint that does not require authentication. Responses are cached for 5 minutes.

GET
/stats

Response Body

application/json

curl -X GET "https://postgrad.io/api/v1/stats"
{
  "data": {
    "total_entries": 142,
    "categories": 11,
    "last_updated": "2019-08-24T14:15:22Z",
    "active_feeds": 4
  },
  "pagination": null,
  "usage": null,
  "context": null,
  "error": null
}

List categories for a feed

Returns the distinct categories present in the specified feed along with entry counts. **Feed scoping:** Pass a feed UUID in `X-PostGrad-Feed`, or omit the header to auto-select your most-populated feed (the chosen feed is reported in the `X-PostGrad-Feed-Auto-Selected` response header).

Get API usage for current period

Returns the authenticated key's usage for the current billing period in the canonical `usage` envelope block. `data` is `null` — every consumer should read `response.usage` for tier + quota information.