@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Books API
@base https://api.nytimes.com/svc/books/v3
@version 3.0.0
@auth ApiKey api-key in query
@endpoints 6
@toc lists(4), lists.{format}(1), reviews.{format}(1)

@group lists
@endpoint GET /lists/best-sellers/history.json
@optional {age-group: any, author: any, contributor: any, isbn: any, price: any, publisher: any, title: any}
@returns(200)

@endgroup

@group lists.{format}
@endpoint GET /lists.{format}
@optional {list: any, weeks-on-list: any, bestsellers-date: any, date: any, isbn: any, published-date: any, rank: any, rank-last-week: any, offset: any, sort-order: any}
@returns(200)

@endgroup

@group lists
@endpoint GET /lists/{date}/{list}.json
@optional {isbn: any, list-name: any, published-date: any, bestsellers-date: any, weeks-on-list: any, rank: any, rank-last-week: any, offset: any, sort-order: any}
@returns(200)

@endpoint GET /lists/overview.{format}
@optional {published_date: any, api-key: any}
@returns(200)

@endpoint GET /lists/names.{format}
@optional {api-key: any}
@returns(200)

@endgroup

@group reviews.{format}
@endpoint GET /reviews.{format}
@optional {isbn: any, title: any, author: any, api-key: any}
@returns(200)

@endgroup

@end