Find Authors API
The Find Authors endpoint returns a paginated list of authors available in the Koniat database. It supports searching authors by name, making it easy to build search boxes, autocomplete suggestions, author directories, and filter options within your application.
This endpoint returns only author information and does not include the quotes associated with each author.
Purpose
The Find Authors endpoint allows developers to retrieve and search authors efficiently, enabling users to browse inspirational content by their favorite authors.
It is designed to support scalable author discovery while maintaining fast response times through pagination and search capabilities.
Authentication
This endpoint is protected and requires a valid Bearer Access Token.
Include the access token in the request header.
Authorization: Bearer YOUR_ACCESS_TOKEN
Requests without a valid access token will be rejected.
Endpoint
GET
https://api.koniat.com/Api/Gateway/Author/List
Request Headers
| Header | Required | Description |
|---|---|---|
| Authorization | Yes | Bearer Access Token obtained from the Authentication API. |
| Accept | Yes | application/json |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| search | String | No | Search authors by name. |
| page | Integer | No | Page number for paginated results. Default is 1. |
| per_page | Integer | No | Number of records per page. Default value is defined by the API. |
API Request
Expected Output
{
"status": 200,
"type": "RFC reference URL",
"title": "Success",
"dateTime": "UTC Datetime string",
"detail": "Reason?"
}Data Credibility
All author records are maintained by Koniat to ensure:
- Accurate author names
- Consistent formatting
- Unique identifiers
- Reliable search results
- Regular database maintenance
- High-quality metadata
The endpoint is optimized to deliver dependable and production-ready author information.
Key Features
- Search authors by name
- Fast paginated results
- Lightweight responses
- JSON response format
- Secure authenticated access
- RESTful API design
- Scalable for large author collections
- Consistent response structure
Error Handling
The endpoint returns standard HTTP status codes.
| HTTP Status | Description |
|---|---|
| 200 | Authors retrieved successfully. |
| 400 | Invalid request parameters. |
| 401 | Unauthorized or invalid access token. |
| 403 | Access forbidden. |
| 404 | No authors found. |
| 429 | Too many requests. |
| 500 | Internal server error. |
Best Practices
- Use the search parameter to reduce unnecessary data transfer.
- Implement pagination when displaying large author lists.
- Cache frequently accessed author data where appropriate.
- Always include a valid Bearer Access Token.
- Gracefully handle empty result sets when no matching authors are found.
Common Use Cases
The Find Authors endpoint is suitable for:
- Author search functionality
- Autocomplete suggestions
- Author selection dropdowns
- Author directory pages
- Quote filtering by author
- Content management systems
- Web applications
Next Step
Once you have retrieved an author, you can use the Quotes List endpoint to fetch quotes associated with that author by applying the appropriate author filter.