PostGrad
API Reference

List your subscribed feeds

View as Markdown

Returns every feed the authenticated account is actively subscribed to. This is the discovery endpoint bots should call first — every request to `/knowledge` or `/categories` requires a feed id from this list in the `X-PostGrad-Feed` header. No feed header is required to call this endpoint.

GET
/feeds

Authorization

AuthorizationBearer <token>

API key passed as Bearer token. Keys use the pg_live_ prefix for production and pg_test_ for test environments.

In: header

Response Body

application/json

application/json

application/json

curl -X GET "https://postgrad.io/api/v1/feeds"
{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "slug": "agency-growth",
      "name": "Agency Growth Playbook",
      "description": "string",
      "categories": [
        "string"
      ],
      "licensor_name": "string",
      "entry_count": 1217,
      "subscription_status": "active",
      "subscribed_at": "2019-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "total": 142,
    "limit": 5,
    "offset": 0,
    "has_more": true
  },
  "usage": {
    "queries_used": 42,
    "queries_limit": 1000,
    "queries_remaining": 958,
    "period_start": "2026-05-01T00:00:00Z",
    "period_end": "2026-06-01T00:00:00Z",
    "tier": "starter"
  },
  "context": {
    "feed": {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "slug": "string",
      "provider": "string"
    },
    "next_steps": {}
  },
  "error": null
}
{
  "data": null,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key"
  }
}
{
  "data": null,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Try again later."
  }
}

API Reference

Complete reference for all PostGrad Knowledge API endpoints.

List knowledge entries

Returns paginated knowledge entries from a specific feed, with optional filtering by category, search query, confidence threshold, and date. Results are ordered by most recently updated. **Feed scoping:** This endpoint requires a feed UUID in the `X-PostGrad-Feed` header — pagination and ordering need a single scoped feed. Call `GET /api/v1/feeds` to list the feeds you are subscribed to. `all` is NOT accepted here; use `/knowledge/search?feed=all` for cross-feed queries.