# Search for authors

The Authors endpoint allows you to fetch authors of content that Constellation has analyzed. Each author includes bio information, summary statistics of posts and account info, and an assessment of their profile.

Endpoint: POST /authors/-/search

## Query parameters:

  - `projectId` (string, required)
    The ID of the project to find records within

## Request fields (application/json):

  - `query` (any)

  - `boolean` (string)
    A lucene query to filter on author criteria. Provides the same intent as query, but more text-friendly way of specifying the filter. If both boolean and query are provided, they are combined with a logical AND.

  - `sort` (array)
    A list of fields to sort by.

  - `sort.field` (string, required)

  - `sort.direction` (string, required)
    Enum: "ASC", "DESC"

  - `page` (object)
    Pagination information.

  - `page.first` (integer)

  - `page.after` (string)

## Response 200 fields (application/json):

  - `authors` (array, required)
    Example: [{"authorId":"1324f3rcdq34cwq3sxwerc23"}]

  - `authors.allAuthorText` (string)
    Search across all author text fields - author.username, author.displayName, author.profileBio, author.bioLocation. NOTE - Not actually returned as a field in the response, but documented here to facilitate describing the filterability.

  - `authors.allNarrativeText` (string)
    Search across all narrative text fields - narrative.title, narrative.compassHeadline, narrative.compassSummary, narrative.compassOneSentence, narrative.executiveBriefing. NOTE - Not actually returned as a field in the response, but documented here to facilitate describing the filterability.

  - `authors.allPostText` (string)
    Search across all post text content fields - title, body. NOTE - Not actually returned as a field in the response, but documented here to facilitate describing the filterability.

  - `authors.accountCreatedAt` (string)
    The date the the author created their account. (ISO 8601, UTC)

  - `authors.bioLocation` (string)
    The author's stated location.

  - `authors.bioUrl` (string)
    The author's website URL.

  - `authors.cohorts` (object)
    Author classification cohorts. Query as author.cohorts:Label>=0.5

  - `authors.displayName` (string)
    The author's display name.

  - `authors.followers` (number)
    Number of followers the author has.

  - `authors.following` (number)
    Number of accounts the author follows.

  - `authors.isBotLike` (boolean)
    Whether the author was determined to be a bot or not.

  - `authors.platform` (string)
    The platform the author is on.

  - `authors.postCount` (number)
    Total number of posts by the author.

  - `authors.profileBio` (string)
    The author's profile description/bio.

  - `authors.username` (string)
    The author's username/handle.

  - `authors.authorId` (string, required)
    The unique identifier for the author of the post.
    Example: "1324f3rcdq34cwq3sxwerc23"

  - `pageInfo` (object, required)
    Example: {"hasNextPage":true,"endCursor":"eyJjcmVhdGVkQXQiOiIyMDI1LTA4LTI3VDAxOjAwOjEyLjAwMFoiLCJwb3N0SWQiOiIxOTYwNTA3NjA3Njg2MjA1ODc5In0=","sortKey":"created_at DESC, post_id ASC"}

  - `pageInfo.hasNextPage` (boolean, required)
    Example: true

  - `pageInfo.endCursor` (string)
    Example: "eyJjcmVhdGVkQXQiOiIyMDI1LTA4LTI3VDAxOjAwOjEyLjAwMFoiLCJwb3N0SWQiOiIxOTYwNTA3NjA3Njg2MjA1ODc5In0="

  - `pageInfo.totalCount` (number)

  - `pageInfo.sortKey` (string)
    Example: "created_at DESC, post_id ASC"