Content

List posts

Changed on

Returns posts for the organization the API key belongs to, newest first by default. Only published posts are included unless you pass status=draft,published. Blog posts and changelogs include a metadata object with cover image, tags, excerpt, authors, featured, noindex, hidden and displayDate; it is null for other content types.

get/v1/posts

Request

  • Base URL: https://api.usenotra.com
  • URL: https://api.usenotra.com/v1/posts
  • Auth: HTTP bearer

Query parameters

sort'asc' | 'desc'

Sort by creation date

Example:desc
limitinteger

Items per page

Example:10
pageinteger

Page number

Example:1
statusstring

Filter by status using a comma-separated list.

contentTypestring

Filter by content type using a comma-separated list.

brandIdentityIdstring

Filter by brand identity ID using a comma-separated list.

Response

Posts fetched successfully

Example response

{
  "posts": [
    {
      "metadata": {
        "coverImage": {
          "url": "https://cdn.example.com/covers/ship-notes.png",
          "alt": "Screenshot of the new editor"
        },
        "tags": [
          "editor",
          "performance"
        ],
        "excerpt": "The editor now opens twice as fast on long posts.",
        "authors": [
          {
            "id": "auth_8f2kq1",
            "slug": "jane-doe",
            "name": "Jane Doe",
            "title": "Head of Product",
            "avatarUrl": "https://cdn.example.com/avatars/jane.png"
          }
        ],
        "displayDate": "2026-10-01"
      }
    }
  ]
}

Changes