Query structured spec data via REST or MCP. Get exactly what your agent needs.
https://api.nytimes.com/svc/books/v3
No endpoints found for this provider.
ListGetBestSellersResponse
{
"type": "object",
"properties": {
"status": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"rank": {
"type": "integer"
},
"isbns": {
"type": "array",
"items": {
"type": "object",
"properties": {
"isbn10": {
"type": "string"
},
"isbn13": {
"type": "string"
}
}
}
},
"dagger": {
"type": "integer"
},
"reviews": {
"type": "array",
"items": {
"type": "object",
"properties": {
"book_review_link": {
"type": "string"
},
"first_chapter_link": {
"type": "string"
},
"sunday_review_link": {
"type": "string"
},
"article_chapter_link": {
"type": "string"
}
}
}
},
"asterisk": {
"type": "integer"
},
"list_name": {
"type": "string"
},
"book_details": {
"type": "array",
"items": {
"type": "object",
"properties": {
"price": {
"type": "integer"
},
"title": {
"type": "string"
},
"author": {
"type": "string"
},
"age_group": {
"type": "string"
},
"publisher": {
"type": "string"
},
"contributor": {
"type": "string"
},
"description": {
"type": "string"
},
"primary_isbn10": {
"type": "string"
},
"primary_isbn13": {
"type": "string"
},
"contributor_note": {
"type": "string"
}
}
}
},
"display_name": {
"type": "string"
},
"weeks_on_list": {
"type": "integer"
},
"published_date": {
"type": "string"
},
"rank_last_week": {
"type": "integer"
},
"bestsellers_date": {
"type": "string"
},
"amazon_product_url": {
"type": "string"
}
}
}
},
"copyright": {
"type": "string"
},
"num_results": {
"type": "integer"
},
"last_modified": {
"type": "string"
}
}
}
ListGetByDateResponse
{
"type": "object",
"properties": {
"status": {
"type": "string"
},
"results": {
"type": "object",
"properties": {
"books": {
"type": "array",
"items": {
"type": "object",
"properties": {
"rank": {
"type": "integer"
},
"isbns": {
"type": "array",
"items": {
"type": "object",
"properties": {
"isbn10": {
"type": "string"
},
"isbn13": {
"type": "string"
}
}
}
},
"price": {
"type": "integer"
},
"title": {
"type": "string"
},
"author": {
"type": "string"
},
"dagger": {
"type": "integer"
},
"asterisk": {
"type": "integer"
},
"age_group": {
"type": "string"
},
"publisher": {
"type": "string"
},
"book_image": {
"type": "string"
},
"contributor": {
"type": "string"
},
"description": {
"type": "string"
},
"weeks_on_list": {
"type": "integer"
},
"primary_isbn10": {
"type": "string"
},
"primary_isbn13": {
"type": "string"
},
"rank_last_week": {
"type": "integer"
},
"book_review_link": {
"type": "string"
},
"contributor_note": {
"type": "string"
},
"amazon_product_url": {
"type": "string"
},
"first_chapter_link": {
"type": "string"
},
"sunday_review_link": {
"type": "string"
},
"article_chapter_link": {
"type": "string"
}
}
}
},
"updated": {
"type": "string"
},
"list_name": {
"type": "string"
},
"corrections": {
"type": "array",
"items": {
"type": "object",
"properties": {}
}
},
"display_name": {
"type": "string"
},
"published_date": {
"type": "string"
},
"bestsellers_date": {
"type": "string"
},
"normal_list_ends_at": {
"type": "integer"
}
}
},
"copyright": {
"type": "string"
},
"num_results": {
"type": "integer"
},
"last_modified": {
"type": "string"
}
}
}
ListGetHistoryResponse
{
"type": "object",
"properties": {
"status": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"isbns": {
"type": "array",
"items": {
"type": "object",
"properties": {
"isbn10": {
"type": "string"
},
"isbn13": {
"type": "string"
}
}
}
},
"price": {
"type": "integer"
},
"title": {
"type": "string"
},
"author": {
"type": "string"
},
"reviews": {
"type": "array",
"items": {
"type": "object",
"properties": {
"book_review_link": {
"type": "string"
},
"first_chapter_link": {
"type": "string"
},
"sunday_review_link": {
"type": "string"
},
"article_chapter_link": {
"type": "string"
}
}
}
},
"age_group": {
"type": "string"
},
"publisher": {
"type": "string"
},
"contributor": {
"type": "string"
},
"description": {
"type": "string"
},
"ranks_history": {
"type": "array",
"items": {
"type": "object",
"properties": {
"rank": {
"type": "integer"
},
"dagger": {
"type": "integer"
},
"asterisk": {
"type": "integer"
},
"list_name": {
"type": "string"
},
"display_name": {
"type": "string"
},
"weeks_on_list": {
"type": "integer"
},
"primary_isbn10": {
"type": "string"
},
"primary_isbn13": {
"type": "string"
},
"published_date": {
"type": "string"
},
"ranks_last_week": {
"nullable": true
},
"bestsellers_date": {
"type": "string"
}
}
}
},
"contributor_note": {
"type": "string"
}
}
}
},
"copyright": {
"type": "string"
},
"num_results": {
"type": "integer"
}
}
}
ListGetNamesResponse
{
"type": "object",
"properties": {
"status": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"updated": {
"enum": [
"WEEKLY",
"MONTHLY"
],
"type": "string"
},
"list_name": {
"type": "string"
},
"display_name": {
"type": "string"
},
"list_name_encoded": {
"type": "string"
},
"newest_published_date": {
"type": "string"
},
"oldest_published_date": {
"type": "string"
}
}
}
},
"copyright": {
"type": "string"
},
"num_results": {
"type": "integer"
}
}
}
OverviewResponse
{
"type": "object",
"properties": {
"status": {
"type": "string"
},
"results": {
"type": "object",
"properties": {
"lists": {
"type": "array",
"items": {
"type": "object",
"properties": {
"books": {
"type": "array",
"items": {
"type": "object",
"properties": {
"rank": {
"type": "integer"
},
"price": {
"type": "integer"
},
"title": {
"type": "string"
},
"author": {
"type": "string"
},
"age_group": {
"type": "string"
},
"publisher": {
"type": "string"
},
"contributor": {
"type": "string"
},
"description": {
"type": "string"
},
"created_date": {
"type": "string"
},
"updated_date": {
"type": "string"
},
"primary_isbn10": {
"type": "string"
},
"primary_isbn13": {
"type": "string"
},
"contributor_note": {
"type": "string"
}
}
}
},
"list_id": {
"type": "integer"
},
"updated": {
"type": "string"
},
"list_name": {
"type": "string"
},
"list_image": {
"type": "string"
},
"display_name": {
"type": "string"
}
}
}
},
"published_date": {
"type": "string"
},
"bestsellers_date": {
"type": "string"
}
}
},
"copyright": {
"type": "string"
},
"num_results": {
"type": "integer"
}
}
}
ReviewGetBookReviewsResponse
{
"type": "object",
"properties": {
"status": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"byline": {
"type": "string"
},
"isbn13": {
"type": "array",
"items": {
"type": "string"
}
},
"summary": {
"type": "string"
},
"book_title": {
"type": "string"
},
"book_author": {
"type": "string"
},
"publication_dt": {
"type": "string"
}
}
}
},
"copyright": {
"type": "string"
},
"num_results": {
"type": "integer"
}
}
}