BizKitHub
DocsAPI ReferencePost/api/v1/post/author-list
getPostPublic API v1

/api/v1/post/author-list

Returns a paginated feed of authors that have shipped at least one publicly visible published post in the organisation. Powers the /autori index page + footer/sitemap author list.

Only main authors are counted. Co-authors do not appear in the index — the "authors" page convention on news sites lists primary bylines only. Co-author attributions still show up on individual article pages via /api/v1/post/post authors[].

Batched route resolution. Every returned author already carries the routable slug (lazy backfilled server-side in one round-trip regardless of author count). Feed into your /autor/<slug> URL pattern directly.

Article feed per author: /api/v1/post/feed?author=<slug-or-id>.

postgetApiV1PostAuthor-list

Parameters

5 query

Query parameters

· 5
apiKeystringRequired

Your BizKitHub API key (passed as GET parameter).

Key format: A 32-character string matching: ^(PROD|DEV_|ROOT)[A-Za-z0-9]{28}$
Prefixes: PROD (production key), DEV_ (individual developer), ROOT (system key with no limits). Learn more

ExamplePRODPGrFxpGEtrOZfuWhnoJohUYBXuOE
localestringOptional

Communication locale code — controls the language of textual data (product names, descriptions, articles, storefront UI, transactional e-mails).

Preferred format: BCP 47 language tag — language[-Script][-REGION]. Use the full tag whenever the script or region matters:

  • en-GB vs. en-US (British vs. American spelling)
  • pt-PT vs. pt-BR (European vs. Brazilian Portuguese)
  • zh-Hans vs. zh-Hant (Simplified vs. Traditional Chinese)
  • sr-Latn vs. sr-Cyrl (Latin vs. Cyrillic Serbian)

Backwards-compatible fallback: the bare two-letter ISO 639-1 code (cs, en, pl, …) is accepted indefinitely — legacy clients that only send the language subtag continue to work unchanged.

Resolution algorithm (server-side): the input is resolved against the supported locale list via the [RFC 4647 Lookup] progressive-fallback strategy — trailing subtags are stripped one by one until a supported locale is found. Example: en-GB-oxendict → en-GB → en (matched). If no subtag combination is supported, the request is rejected.

Currently supported locales: cs, en, fr, it, pl, de, sk, sv, es, zh, ja, uk, da, hu, ro, nl, pt, fi, nb, hr. Region-specific variants (e.g. en-GB, pt-BR) are accepted and resolved to their base language when the exact variant is not registered separately.

Length: 2–35
Examplecs
limitstring | integerOptional

Maximum number of authors to return. Default 50, hard-capped at 200.

Range: 1–200
Example50
offsetstring | integerOptional

Zero-based pagination offset. Use with limit + hasMore/total.

Range: 0–∞
Example0
orderBy"postCount:desc" | "lastPublishedDate:desc" | "name:asc"Optional

Ordering of the returned list. Default postCount:desc — editorial standard (prolific journalists first, matches how news sites present /autori indexes). lastPublishedDate:desc = "recently active" (best for dynamic sidebars). name:asc = predictable alphabetical directory (best for print-style team pages).

ExamplepostCount:desc

Response schema

1 status code documented

200Success
itemsobject[]Required
Each array item:
idstringRequired

Contact shop__contact.external_id (16-char).

Example71E58E5SjdZN6ut3
slugstringRequired

Routable profile slug for the current locale (same across every org locale).

Examplejan-barasek
namestringRequired

Display name (first_name last_name).

ExampleJan Barášek
jobTitlestringOptional

Free-form job title. Omitted for former (blocked / non-member) authors.

ExampleEditor in Chief
avatarUrlstringOptional

Fully qualified avatar URL. Omitted when unset.

Examplehttps://storage.xhp.cz/avatar/…
postCountnumberRequired

Count of publicly visible published posts main-authored by this contact.

Example42
lastPublishedDateDate | string | string | numberOptional

Publish date of the newest post main-authored by this contact.

One of 4:
Variant 1
Date

Publish date of the newest post main-authored by this contact.

Example2026-04-15T09:12:00.000Z
Variant 2
stringdate-time
Variant 3
stringdate
Variant 4
number
totalnumberRequired

Total number of authors matching the base filter (published-post owners). Independent of limit/offset.

Example23
hasMorebooleanRequired

offset + items.length < total — true when more pages are available.

Examplestruefalse

Response example

application/json
{
  "items": [
    {
      "id": "71E58E5SjdZN6ut3",
      "slug": "jan-barasek",
      "name": "Jan Barášek",
      "jobTitle": "Editor in Chief",
      "avatarUrl": "https://storage.xhp.cz/avatar/…",
      "postCount": 42,
      "lastPublishedDate": "2026-04-15T09:12:00.000Z"
    }
  ],
  "total": 23,
  "hasMore": true
}

Request example

GET /api/v1/post/author-list

get
curl -X GET "https://api.bizkithub.com/api/v1/post/author-list?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE&locale=cs&limit=50&offset=0&orderBy=postCount%3Adesc" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key