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
​
locale
string

Filter the embedded recent_posts list to posts in the given locale (e.g. en, es). The author itself is shared across locales and is always returned. When omitted, defaults to your organization's default locale.

Returns 400 if the value is not a locale configured on your organization.

Maximum string length: 10

Response

Authors retrieved successfully

Response structure for listing all authors

​
data
object[]

Array of author objects