Skip to main content
GET
/
authors
Authors
curl --request GET \
  --url https://api.example.com/authors

List Authors

GET /authors

Query Parameters

ParameterTypeDefaultDescription
pageinteger1Page number
perPageinteger50Items per page
sortstringnameSort field

Example Request

curl -X GET "https://api.skayle.ai/v1/authors" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "data": [
    {
      "id": "author_abc123",
      "type": "author",
      "attributes": {
        "name": "John Doe",
        "slug": "john-doe",
        "bio": "Technical writer and developer advocate",
        "avatar": "https://cdn.skayle.io/avatars/john.jpg",
        "postCount": 12
      }
    },
    {
      "id": "author_def456",
      "type": "author",
      "attributes": {
        "name": "Jane Smith",
        "slug": "jane-smith",
        "bio": "Senior content strategist",
        "avatar": "https://cdn.skayle.io/avatars/jane.jpg",
        "postCount": 8
      }
    }
  ],
  "meta": {
    "total": 5
  }
}

Get Author

GET /authors/{id}
GET /authors/slug/{slug}

Example Response

{
  "data": {
    "id": "author_abc123",
    "type": "author",
    "attributes": {
      "name": "John Doe",
      "slug": "john-doe",
      "bio": "Technical writer and developer advocate",
      "avatar": "https://cdn.skayle.io/avatars/john.jpg",
      "email": "john@example.com",
      "social": {
        "twitter": "johndoe",
        "linkedin": "johndoe"
      },
      "postCount": 12
    }
  }
}

Get Posts by Author

GET /authors/{id}/posts
GET /authors/slug/{slug}/posts
Returns paginated posts by the specified author.

Example Request

curl -X GET "https://api.skayle.ai/v1/authors/slug/john-doe/posts?perPage=10" \
  -H "Authorization: Bearer YOUR_API_KEY"