List blog posts

Returns a list of blog posts which the current user may access

Pagination

Use page[number] and page[size] parameters to paginate results:

Get first page of 10 items

• GET /v1/blog_posts[number]=1&page[size]=10

Get second page of 25 items

• GET /v1/blog_posts[number]=2&page[size]=25

Sparse Fields

Use the fields[blog_posts] parameter to request only specific attributes:

Only return title attribute

• GET /v1/blog_posts?fields[blog_posts]=title

Sorting

Use the sort parameter to sort the results:

Sort by published_at in descending order

• GET /v1/blog_posts?sort=-published_at&fields[blog_posts]=title

Filters

Use the filter[site_id] parameter to get blog posts for a specific site:

Get blog posts for site with ID 123

• GET /v1/blog_posts?filter[site_id]=123

List of attributes that may be used to filter: title, content, slug, page_title, page_description, published_at, created_at, updated_at, image_url, image_alt_text, tags

The filter param uses the following syntax: filter[attribute_name_suffix] with suffix for comparison:

• eq for equals
• cont for contains
• not_eq for not equals
• not_cont for not contains
• start for starts with
• end for ends with

For example:

• GET /v1/blog_posts?filter[title_start]=Announcing
• GET /v1/blog_posts?filter[title_cont]=Announcing

GET /v1/blog_posts

List blog posts

cURL

curl --request GET \
  --url https://api.kajabi.com/v1/blog_posts \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "id": "<string>",
      "type": "blog_posts",
      "attributes": {
        "title": "<string>",
        "url": "<string>",
        "content": "<string>",
        "slug": "<string>",
        "page_title": "<string>",
        "page_description": "<string>",
        "published_at": "<string>",
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z"
      },
      "relationships": {
        "blog": {
          "data": {
            "id": "<string>",
            "type": "<string>"
          }
        }
      }
    }
  ],
  "links": {
    "self": "<string>",
    "current": "<string>"
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

sort · string

Sort order, use: title for descending order use '-' e.g. &sort=-title

page[number] · integer

page[size] · integer

Number of documents

fields[blog_posts] · string

Partial attributes as specified, e.g. fields[blog_posts]=title

filter[title_cont] · string

Filter by title contains, for example ?filter[title_cont]=hello

Response

200

application/vnd.api+json

Success, list of blog posts which the current user may access

data · object[]

Show child attributes

links · object

Show child attributes