Skip to main content
GET
/
authors
List All Authors
curl --request GET \
  --url https://api.buttercms.com/v2/authors/ \
  --header 'Authorization: <api-key>'
{
  "data": [
    {
      "slug": "api-test",
      "first_name": "API",
      "last_name": "Test",
      "email": "apitest@buttercms.com",
      "bio": "This is my bio.",
      "title": "API",
      "linkedin_url": "https://www.linkedin.com/in/API",
      "facebook_url": "https://www.facebook.com/API",
      "pinterest_url": "https://www.pinterest.com/API",
      "instagram_url": "https://www.instagram.com/API",
      "twitter_handle": "buttercmsapi",
      "profile_image": "https://buttercms.com/api.png"
    },
    {
      "slug": "john-doe",
      "first_name": "John",
      "last_name": "Doe",
      "email": "john@example.com",
      "bio": "Experienced content writer and blogger.",
      "title": "Senior Writer",
      "linkedin_url": "https://www.linkedin.com/in/johndoe",
      "facebook_url": null,
      "pinterest_url": null,
      "instagram_url": "https://www.instagram.com/johndoe",
      "twitter_handle": "johndoe",
      "profile_image": "https://cdn.buttercms.com/profiles/john-doe.jpg"
    }
  ]
}
Retrieve a complete list of all blog post authors in your organization, including their profile information and optional recent post data. This endpoint is ideal for building author pages, contributor listings, and author-based navigation. Author Profiles: Returns comprehensive profile information for each author, including personal details like name and bio, social media profiles, profile images, and author metadata. This provides everything needed to build rich author profile pages. Recent Posts Integration: Use the include=recent_posts parameter to enrich the response with each author’s most recent blog posts. This is particularly useful for creating author archive pages that showcase both the author’s profile and their latest content contributions.

Authorizations

​
Authorization
string
header
required

Set the Authorization header to Token your_read_api_token.

Example: Authorization: Token abc123def456

Note: The header value includes the Token prefix.

You can access your API token from your settings page.

Query Parameters

​
auth_token
string

Your ButterCMS read API token

​
include
enum<string>

Include additional data in the response.

When set to recent_posts, each author object will include a recent_posts array containing their latest blog posts.

Available options:
recent_posts

Response

Authors retrieved successfully

Response structure for listing all authors

​
data
object[]

Array of author objects