Channels API

Channels represent publishing destinations in Wortfreunde, a blog, a LinkedIn profile, a newsletter, etc. Each channel belongs to a team and contains posts.

Endpoints

List Channels

Retrieve a paginated list of all channels accessible with your API key.

GET /channels

Query Parameters

Example Request

curl -s https://api.wortfreunde.ch/v1/channels \
  -H "Authorization: Bearer $WORTFREUNDE_API_KEY" | python3 -m json.tool

Response

{
  "data": [
    {
      "id": 161,
      "title": "Blog",
      "platform": "git",
      "team": {
        "id": 42,
        "name": "Wortfreunde"
      },
      "posts_count": 3
    },
    {
      "id": 17,
      "title": "LinkedIn",
      "platform": "linkedin",
      "team": null,
      "posts_count": 5
    },
  ],
  "meta": {
    "page": 1,
    "pages": 1,
    "count": 5,
    "per_page": 20
  }
}

Response Fields

Platform Types

Pagination

The meta object contains pagination details:

Get Channel

Retrieve a single channel by its ID.

GET /channels/{id}

Path Parameters

Example Request

curl -s https://api.wortfreunde.ch/v1/channels/161 \
  -H "Authorization: Bearer $WORTFREUNDE_API_KEY" | python3 -m json.tool

Response

{
  "data": {
    "id": 161,
    "title": "Blog",
    "platform": "git",
    "team": {
      "id": 42,
      "name": "Wortfreunde"
    },
    "posts_count": 3,
    "created_at": "2026-02-26T09:34:58.251Z",
    "updated_at": "2026-02-26T15:29:05.704Z"
  }
}

Response Fields

The single channel response includes all fields from the list response, plus:

Error Responses

Channel Not Found

curl -s https://api.wortfreunde.ch/v1/channels/99999 \
  -H "Authorization: Bearer $WORTFREUNDE_API_KEY"

{
  "error": {
    "code": "not_found",
    "message": "Resource not found"
  }
}