GET
/
blogs
/
v3
/
blog-authors
/
search
Search blog authors
curl --request GET \
  --url https://api.hubapi.com/blogs/v3/blog-authors/search
{
  "objects": [
    {
      "portalId": 62515,
      "id": 284839243,
      "created": 1377856983000,
      "updated": 1377856983000,
      "deletedAt": 0,
      "fullName": "Hub Spot",
      "email": "testapi@hubspot.com",
      "userId": 215482,
      "username": "testapi@hubspot.com",
      "slug": "hub-spot",
      "publicUrl": "http://62515.hs-sites.com/blog/author/hub-spot",
      "totalPosts": 73,
      "livePosts": 5,
      "displayName": "Hub Spot",
      "status": "active",
      "googlePlus": "",
      "bio": "",
      "website": "",
      "twitter": "",
      "linkedin": "",
      "facebook": "",
      "avatar": "",
      "gravatarUrl": "https://app.hubspot.com/settings/avatar/bb23f3ae97b9698d130c02d2841e86a4",
      "twitterUsername": "",
      "hasSocialProfiles": false
    }
  ],
  "message": null,
  "total": 11,
  "limit": 1000,
  "offset": 0
}

Query Parameters

​
q
string

Search for authors whose names, emails, or url slugs contain the given string

​
active
boolean

Filter authors by whether or not they have published blog posts (true or false)

​
blog
integer

Filter authors by the blog they have published to (value is a blog ID)

​
order
string

The attribute to order the results by. Prepend a "-" to invert

​
limit
integer
default:20

The maximum number of items to return. Defaults to 20.

Required range: x <= 300
​
offset
integer
default:0

The offset from the beginning of the result set from which to start returning results. Used for paging. Defaults to 0.

​
casing
enum<string>

Use the casing=snake parameter to change the API's casing for all query parameters and JSON fields to snake_case, rather than camelCase, which is the default.

Available options:
snake

Response

200 - application/json

Search results for blog authors.

The response is of type object.