Goodreads 图书 API

API ID 14964

书籍数据:搜索书籍、作者和人物;按ID或ISBN查看书籍详细信息;相似书籍;按阅读顺序排列的系列;带有新发布和最畅销书的类型;列表、名言和奖项获奖者

100% 正常运行时间 2,796 ms 平均响应

API 文档

端点

请求
返回匹配搜索词(标题或作者)的书籍及其分页信息 返回的书籍 ID 可用于 /v1/book 工作 ID 可用于 /v1/book/similar
Endpoint ID: 39236
GET https://zylalabs.com/api/14964/goodreads+books+api/39236/search+books
输入参数

搜索书籍 — 端点功能

对象 描述
q 必需 Search term, at least 3 characters long.
page 可选 Page number, starting from 1 (defaults to 1).

剩余免费测试请求:3 / 3。


输入参数

q
page
API 示例响应
JSON
{
    "page": 1,
    "totalPages": 100,
    "totalResults": 12510,
    "books": [
        {
            "id": 42844155,
            "workId": 4640799,
            "name": "Harry Potter and the Philosopher's Stone",
            "slug": "harry-potter-and-the-philosopher-s-stone",
            "image": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1598823299i/42844155.jpg",
            "authors": [
                {
                    "id": 1077326,
                    "name": "J.K. Rowling",
                    "slug": "J_K_Rowling",
                    "role": null
                },
                {
                    "id": 6458971,
                    "name": "Olly Moss",
                    "slug": "Olly_Moss",
                    "role": "Illustrator"
                }
            ],
            "publishedYear": 2015,
            "editions": 1316,
            "avgRating": 4.47,
            "totalRatings": 11915076
        },
        {
            "id": 5,
            "workId": 2402163,
            "name": "Harry Potter and the Prisoner of Azkaban",
            "slug": "Harry_Potter_and_the_Prisoner_of_Azkaban",
            "image": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1630547330i/5.jpg",
            "authors": [
                {
                    "id": 1077326,
                    "name": "J.K. Rowling",
                    "slug": "J_K_Rowling",
                    "role": null
                },
                {
                    "id": 2927,
                    "name": "Mary GrandPré",
                    "slug": "Mary_GrandPr_",
                    "role": "Illustrator"
                }
            ],
            "publishedYear": 2004,
            "editions": 916,
            "avgRating": 4.58,
            "totalRatings": 5095624
        },
        {
            "id": 58613224,
            "workId": 2963218,
            "name": "Harry Potter and the Deathly Hallows",
            "slug": "harry-potter-and-the-deathly-hallows",
            "image": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1627042661i/58613224.jpg",
            "authors": [
                {
                    "id": 1077326,
                    "name": "J.K. Rowling",
                    "slug": "J_K_Rowling",
                    "role": null
                },
                {
                    "id": 2927,
                    "name": "Mary GrandPré",
                    "slug": "Mary_GrandPr_",
                    "role": "Illustrator"
                }
            ],
            "publishedYear": 2007,
            "editions": 641,
            "avgRating": 4.62,
            "totalRatings": 4267903
        },
        {
            "id": 58613451,
            "workId": 2809203,
            "name": "Harry Potter and the Order of the Phoenix",
            "slug": "harry-potter-and-the-order-of-the-phoenix",
            "image": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1627045351i/58613451.jpg",
            "authors": [
                {
                    "id": 1077326,
                    "name": "J.K. Rowling",
                    "slug": "J_K_Rowling",
                    "role": null
                },
                {
                    "id": 2927,
                    "name": "Mary GrandPré",
                    "slug": "Mary_GrandPr_",
                    "role": "Illustrator"
                }
            ],
            "publishedYear": 2003,
            "editions": 680,
            "avgRating": 4.5,
            "totalRatings": 3963764
        },
        {
            "id": 239754337,
            "workId": 6231171,
            "name": "Harry Potter and the Chamber of Secrets",
            "slug": "harry-potter-and-the-chamber-of-secrets",
            "image": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1791230627i/239754337.jpg",
            "authors": [
                {
                    "id": 1077326,
                    "name": "J.K. Rowling",
                    "slug": "J_K_Rowling",
                    "role": null
                },
                {
                    "id": 25372,
                    "name": "Hugh Laurie",
                    "slug": "Hugh_Laurie",
                    "role": "Narrator"
                },
                {
                    "id": 418921,
                    "name": "Matthew MacFadyen",
                    "slug": "Matthew_MacFadyen",
                    "role": "Narrator"
                }
            ],
            "publishedYear": 2025,
            "editions": 946,
            "avgRating": 4.43,
            "totalRatings": 4713069
        },
        {
            "id": 29056083,
            "workId": 48765776,
            "name": "Harry Potter and the Cursed Child: Parts One and Two",
            "slug": "harry-potter-and-the-cursed-child",
            "image": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1470082995i/29056083.jpg",
            "authors": [
                {
                    "id": 5042201,
                    "name": "John Tiffany",
                    "slug": "John_Tiffany",
                    "role": "Adaptor"
                },
                {
                    "id": 3439408,
                    "name": "Jack Thorne",
                    "slug": "Jack_Thorne",
                    "role": "Adaptor"
                },
                {
                    "id": 1077326,
                    "name": "J.K. Rowling",
                    "slug": "J_K_Rowling",
                    "role": null
                }
            ],
            "publishedYear": 2016,
            "editions": 208,
            "avgRating": 3.47,
            "totalRatings": 1178924
        },
        {
            "id": 58613424,
            "workId": 3046572,
            "name": "Harry Potter and the Goblet of Fire",
            "slug": "harry-potter-and-the-goblet-of-fire",
            "image": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1627044952i/58613424.jpg",
            "authors": [
                {
                    "id": 1077326,
                    "name": "J.K. Rowling",
                    "slug": "J_K_Rowling",
                    "role": null
                },
                {
                    "id": 2927,
                    "name": "Mary GrandPré",
                    "slug": "Mary_GrandPr_",
                    "role": "Illustrator"
                }
            ],
            "publishedYear": 2000,
            "editions": 844,
            "avgRating": 4.56,
            "totalRatings": 4392449
        },
        {
            "id": 58613345,
            "workId": 41335427,
            "name": "Harry Potter and the Half-Blood Prince",
            "slug": "harry-potter-and-the-half-blood-prince",
            "image": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1627043894i/58613345.jpg",
            "authors": [
                {
                    "id": 1077326,
                    "name": "J.K. Rowling",
                    "slug": "J_K_Rowling",
                    "role": null
                },
                {
                    "id": 2927,
                    "name": "Mary GrandPré",
                    "slug": "Mary_GrandPr_",
                    "role": "Illustrator"
                }
            ],
            "publishedYear": 2005,
            "editions": 674,
            "avgRating": 4.58,
            "totalRatings": 3810734
        },
        {
            "id": 1317181,
            "workId": 19079807,
            "name": "Harry Potter and the Order of the Phoenix",
            "slug": "Harry_Potter_and_the_Order_of_the_Phoenix",
            "image": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1182710609i/1317181.jpg",
            "authors": [
                {
                    "id": 1077326,
                    "name": "J.K. Rowling",
                    "slug": "J_K_Rowling",
                    "role": null
                }
            ],
            "publishedYear": 2003,
            "editions": 16,
            "avgRating": 4.6,
            "totalRatings": 321701
        },
        {
            "id": 862041,
            "workId": 2962492,
            "name": "Harry Potter Series Box Set",
            "slug": "Harry_Potter_Series_Box_Set",
            "image": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1534298934i/862041.jpg",
            "authors": [
                {
                    "id": 1077326,
                    "name": "J.K. Rowling",
                    "slug": "J_K_Rowling",
                    "role": null
                }
            ],
            "publishedYear": 2007,
            "editions": 235,
            "avgRating": 4.73,
            "totalRatings": 307194
        },
        {
            "id": 2283433,
            "workId": 2289636,
            "name": "Selections from Harry Potter and The Order of the Phoenix: Piano Solos",
            "slug": "Selections_from_Harry_Potter_and_The_Order_of_the_Phoenix",
            "image": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1348986307i/2283433.jpg",
            "authors": [
                {
                    "id": 616,
                    "name": "John Williams",
                    "slug": "John_Williams"
                }
            ]
        }
    ],
    "_note": "Response truncated for documentation purposes"
}
搜索书籍 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14964/goodreads+books+api/39236/search+books?q=harry potter&page=1' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回关于一本书的详细信息:作者、系列、类型、角色、版次数据、购买链接、评分分布和读者人数
Endpoint ID: 39237
GET https://zylalabs.com/api/14964/goodreads+books+api/39237/book+details
输入参数

书籍详情 — 端点功能

对象 描述
id 必需 Book id. Use /v1/search/books to look one up.

剩余免费测试请求:3 / 3。


输入参数

id
API 示例响应
JSON
{
    "id": 2767052,
    "workId": 2792775,
    "name": "The Hunger Games",
    "slug": "the-hunger-games",
    "image": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1586722975i/2767052.jpg",
    "description": "Winning means fame and fortune. Losing means certain death. The Hunger Games have begun. . . .\n\nIn the ruins of a place once known as North America lies the nation of Panem, a shining Capitol surrounded by twelve outlying districts. The Capitol is harsh and cruel and keeps the districts in line by forcing them all to send one boy and one girl between the ages of twelve and eighteen to participate in the annual Hunger Games, a fight to the death on live TV.\n\nSixteen-year-old Katniss Everdeen regards it as a death sentence when she steps forward to take her sister's place in the Games. But Katniss has been close to dead before-and survival, for her, is second nature. Without really meaning to, she becomes a contender. But if she is to win, she will have to start making choices that weigh survival against humanity and life against love.",
    "authors": [
        {
            "id": 153394,
            "name": "Suzanne Collins",
            "slug": "Suzanne_Collins",
            "role": "Author"
        }
    ],
    "series": [
        {
            "id": 73758,
            "name": "The Hunger Games",
            "slug": "the-hunger-games",
            "position": "1"
        }
    ],
    "genres": [
        {
            "name": "Young Adult",
            "slug": "young-adult"
        },
        {
            "name": "Dystopia",
            "slug": "dystopia"
        },
        {
            "name": "Fiction",
            "slug": "fiction"
        },
        {
            "name": "Fantasy",
            "slug": "fantasy"
        },
        {
            "name": "Science Fiction",
            "slug": "science-fiction"
        },
        {
            "name": "Romance",
            "slug": "romance"
        },
        {
            "name": "Adventure",
            "slug": "adventure"
        },
        {
            "name": "Audiobook",
            "slug": "audiobook"
        },
        {
            "name": "Book Club",
            "slug": "book-club"
        },
        {
            "name": "Teen",
            "slug": "teen"
        }
    ],
    "characters": [
        {
            "id": 23874,
            "name": "Katniss Everdeen",
            "slug": "katniss-everdeen"
        },
        {
            "id": 23875,
            "name": "Peeta Mellark",
            "slug": "peeta-mellark"
        },
        {
            "id": 23899,
            "name": "Cato (Hunger Games)",
            "slug": "cato-hunger-games"
        },
        {
            "id": 32723,
            "name": "Primrose Everdeen",
            "slug": "primrose-everdeen"
        },
        {
            "id": 32724,
            "name": "Gale Hawthorne",
            "slug": "gale-hawthorne"
        },
        {
            "id": 32725,
            "name": "Effie Trinket",
            "slug": "effie-trinket"
        },
        {
            "id": 32726,
            "name": "Haymitch Abernathy",
            "slug": "haymitch-abernathy"
        },
        {
            "id": 35441,
            "name": "Cinna",
            "slug": "cinna"
        },
        {
            "id": 42236,
            "name": "Rue",
            "slug": "rue"
        },
        {
            "id": 51202,
            "name": "Flavius",
            "slug": "flavius"
        },
        {
            "id": 51203,
            "name": "Lavinia (Hunger Games)",
            "slug": "lavinia-hunger-games"
        },
        {
            "id": 51204,
            "name": "Marvel",
            "slug": "marvel"
        },
        {
            "id": 51205,
            "name": "Glimmer",
            "slug": "glimmer"
        },
        {
            "id": 51206,
            "name": "Clove",
            "slug": "clove"
        },
        {
            "id": 51207,
            "name": "Foxface",
            "slug": "foxface"
        },
        {
            "id": 51209,
            "name": "Thresh",
            "slug": "thresh"
        },
        {
            "id": 57039,
            "name": "Greasy Sae",
            "slug": "greasy-sae"
        },
        {
            "id": 57040,
            "name": "Madge Undersee",
            "slug": "madge-undersee"
        },
        {
            "id": 57042,
            "name": "Caesar Flickerman",
            "slug": "caesar-flickerman"
        },
        {
            "id": 57043,
            "name": "Claudius Templesmith",
            "slug": "claudius-templesmith"
        },
        {
            "id": 971110,
            "name": "Octavia (Hunger Games)",
            "slug": "octavia-hunger-games"
        },
        {
            "id": 987647,
            "name": "Portia (hunger Games)",
            "slug": "portia-hunger-games"
        },
        {
            "id": 1047163,
            "name": "Coriolanus Snow",
            "slug": "coriolanus-snow"
        }
    ],
    "format": "Hardcover",
    "pages": 374,
    "publisher": "Scholastic Press",
    "publishedDate": "2008-10-14",
    "publishedYear": 2008,
    "language": "English",
    "isbn": "0439023483",
    "isbn13": "9780439023481",
    "asin": "0439023483",
    "ebookPrice": 9.99,
    "kindleUnlimitedEligible": false,
    "buyLinks": [
        {
            "name": "Amazon",
            "type": "kindle",
            "url": "https://www.amazon.com/gp/product/B002MQYOFW/ref=x_gr_bb_kindle?caller=Goodreads&tag=x_gr_bb_kindle-20"
        },
        {
            "name": "Amazon",
            "type": "store",
            "url": "http://www.amazon.com/gp/product/0439023483/ref=x_gr_bb_amazon?ie=UTF8&tag=x_gr_bb_amazon-20&linkCode=as2&camp=1789&creative=9325&creativeASIN=0439023483&SubscriptionId=1MGPYB6YW3HWK55XCGG2"
        },
        {
            "name": "Audible",
            "type": "store",
            "url": "https://www.amazon.com/s?k=The+Hunger+Games&i=audible&ref=x_gr_bb_audible&tag=x_gr_bb_audible-20"
        },
        {
            "name": "Barnes & Noble",
            "type": "store",
            "url": "https://www.barnesandnoble.com/w/?ean=9780439023481"
        },
        {
            "name": "AbeBooks",
            "type": "store",
            "url": "http://affiliates.abebooks.com/c/64613/77416/2029?u=http%3A%2F%2Fwww.abebooks.com%2Fservlet%2FSearchResults%3Fisbn%3D0439023483"
        },
        {
            "name": "Kobo",
            "type": "store",
            "url": "https://click.linksynergy.com/fs-bin/click?id=GwEz7vxblVU&subid=&offerid=361251.1&type=10&tmpid=9309&u1=x_gr_w_bb&RD_PARM1=https%3A%2F%2Fwww.kobo.com%2Fus%2Fen%2Fsearch%3FQuery%3DThe+Hunger+Games"
        },
        {
            "name": "Apple Books",
            "type": "store",
            "url": "https://geo.itunes.apple.com/us/book/isbn9780439023481?at=11lvdC&mt=11&ls=1"
        },
        {
            "name": "Google Play",
            "type": "store",
            "url": "https://play.google.com/store/search?q=9780439023481&c=books&PCamrefID=bookpage&PAffiliateID=10lHMS"
        },
        {
            "name": "Alibris",
            "type": "store",
            "url": "http://click.linksynergy.com/fs-bin/click?id=GwEz7vxblVU&subid=&offerid=189673.1&type=10&tmpid=939&&u1=x_gr_w_bb&RD_PARM1=http%3A%2F%2Fwww.alibris.com%2Fbooksearch%3Fkeyword%3D0439023483"
        },
        {
            "name": "Indigo",
            "type": "store",
            "url": "https://www.chapters.indigo.ca/en-ca/home/search/?keywords=9780439023481"
        },
        {
            "name": "Better World Books",
            "type": "store",
            "url": "http://www.tkqlhce.com/ob117vpyvpxCFFFKMHLCEDHLGHKECEFMIGDFFHJDDD?url=http%3A%2F%2Fwww.betterworldbooks.com%2FThe+Hunger+Games-H0.aspx%3FSearchTerm%3D0439023483"
        },
        {
            "name": "IndieBound",
            "type": "store",
            "url": "https://www.indiebound.org/book/9780439023481"
        },
        {
            "name": "Thriftbooks",
            "type": "store",
            "url": "https://thriftbooks.sjv.io/c/64613/4051236/58330?u=https%3A%2F%2Fwww.thriftbooks.com%2Fbrowse%2F%3Fb.search%3D0439023483"
        }
    ],
    "avgRating": 4.36,
    "totalRatings": 10365797,
    "totalReviews": 282376,
    "currentlyReading": 118196,
    "wantToRead": 1977036,
    "ratingsDistribution": {
        "oneStar": 135002,
        "twoStars": 244246,
        "threeStars": 1126818,
        "fourStars": 3148093,
        "fiveStars": 5711638
    }
}
书籍详情 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14964/goodreads+books+api/39237/book+details?id=2767052' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回有关通过ISBN查找的单本书的详细信息 响应与/v1/book的响应相同
Endpoint ID: 39238
GET https://zylalabs.com/api/14964/goodreads+books+api/39238/book+details+by+isbn
输入参数

通过ISBN获取书籍详情 — 端点功能

对象 描述
isbn 必需 ISBN-10 or ISBN-13 of the book, hyphens are allowed.

剩余免费测试请求:3 / 3。


输入参数

isbn
API 示例响应
JSON
{
    "id": 2767052,
    "workId": 2792775,
    "name": "The Hunger Games",
    "slug": "the-hunger-games",
    "image": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1586722975i/2767052.jpg",
    "description": "Winning means fame and fortune. Losing means certain death. The Hunger Games have begun. . . .\n\nIn the ruins of a place once known as North America lies the nation of Panem, a shining Capitol surrounded by twelve outlying districts. The Capitol is harsh and cruel and keeps the districts in line by forcing them all to send one boy and one girl between the ages of twelve and eighteen to participate in the annual Hunger Games, a fight to the death on live TV.\n\nSixteen-year-old Katniss Everdeen regards it as a death sentence when she steps forward to take her sister's place in the Games. But Katniss has been close to dead before-and survival, for her, is second nature. Without really meaning to, she becomes a contender. But if she is to win, she will have to start making choices that weigh survival against humanity and life against love.",
    "authors": [
        {
            "id": 153394,
            "name": "Suzanne Collins",
            "slug": "Suzanne_Collins",
            "role": "Author"
        }
    ],
    "series": [
        {
            "id": 73758,
            "name": "The Hunger Games",
            "slug": "the-hunger-games",
            "position": "1"
        }
    ],
    "genres": [
        {
            "name": "Young Adult",
            "slug": "young-adult"
        },
        {
            "name": "Dystopia",
            "slug": "dystopia"
        },
        {
            "name": "Fiction",
            "slug": "fiction"
        },
        {
            "name": "Fantasy",
            "slug": "fantasy"
        },
        {
            "name": "Science Fiction",
            "slug": "science-fiction"
        },
        {
            "name": "Romance",
            "slug": "romance"
        },
        {
            "name": "Adventure",
            "slug": "adventure"
        },
        {
            "name": "Audiobook",
            "slug": "audiobook"
        },
        {
            "name": "Book Club",
            "slug": "book-club"
        },
        {
            "name": "Teen",
            "slug": "teen"
        }
    ],
    "characters": [
        {
            "id": 23874,
            "name": "Katniss Everdeen",
            "slug": "katniss-everdeen"
        },
        {
            "id": 23875,
            "name": "Peeta Mellark",
            "slug": "peeta-mellark"
        },
        {
            "id": 23899,
            "name": "Cato (Hunger Games)",
            "slug": "cato-hunger-games"
        },
        {
            "id": 32723,
            "name": "Primrose Everdeen",
            "slug": "primrose-everdeen"
        },
        {
            "id": 32724,
            "name": "Gale Hawthorne",
            "slug": "gale-hawthorne"
        },
        {
            "id": 32725,
            "name": "Effie Trinket",
            "slug": "effie-trinket"
        },
        {
            "id": 32726,
            "name": "Haymitch Abernathy",
            "slug": "haymitch-abernathy"
        },
        {
            "id": 35441,
            "name": "Cinna",
            "slug": "cinna"
        },
        {
            "id": 42236,
            "name": "Rue",
            "slug": "rue"
        },
        {
            "id": 51202,
            "name": "Flavius",
            "slug": "flavius"
        },
        {
            "id": 51203,
            "name": "Lavinia (Hunger Games)",
            "slug": "lavinia-hunger-games"
        },
        {
            "id": 51204,
            "name": "Marvel",
            "slug": "marvel"
        },
        {
            "id": 51205,
            "name": "Glimmer",
            "slug": "glimmer"
        },
        {
            "id": 51206,
            "name": "Clove",
            "slug": "clove"
        },
        {
            "id": 51207,
            "name": "Foxface",
            "slug": "foxface"
        },
        {
            "id": 51209,
            "name": "Thresh",
            "slug": "thresh"
        },
        {
            "id": 57039,
            "name": "Greasy Sae",
            "slug": "greasy-sae"
        },
        {
            "id": 57040,
            "name": "Madge Undersee",
            "slug": "madge-undersee"
        },
        {
            "id": 57042,
            "name": "Caesar Flickerman",
            "slug": "caesar-flickerman"
        },
        {
            "id": 57043,
            "name": "Claudius Templesmith",
            "slug": "claudius-templesmith"
        },
        {
            "id": 971110,
            "name": "Octavia (Hunger Games)",
            "slug": "octavia-hunger-games"
        },
        {
            "id": 987647,
            "name": "Portia (hunger Games)",
            "slug": "portia-hunger-games"
        },
        {
            "id": 1047163,
            "name": "Coriolanus Snow",
            "slug": "coriolanus-snow"
        }
    ],
    "format": "Hardcover",
    "pages": 374,
    "publisher": "Scholastic Press",
    "publishedDate": "2008-10-14",
    "publishedYear": 2008,
    "language": "English",
    "isbn": "0439023483",
    "isbn13": "9780439023481",
    "asin": "0439023483",
    "ebookPrice": 9.99,
    "kindleUnlimitedEligible": false,
    "buyLinks": [
        {
            "name": "Amazon",
            "type": "kindle",
            "url": "https://www.amazon.com/gp/product/B002MQYOFW/ref=x_gr_bb_kindle?caller=Goodreads&tag=x_gr_bb_kindle-20"
        },
        {
            "name": "Amazon",
            "type": "store",
            "url": "http://www.amazon.com/gp/product/0439023483/ref=x_gr_bb_amazon?ie=UTF8&tag=x_gr_bb_amazon-20&linkCode=as2&camp=1789&creative=9325&creativeASIN=0439023483&SubscriptionId=1MGPYB6YW3HWK55XCGG2"
        },
        {
            "name": "Audible",
            "type": "store",
            "url": "https://www.amazon.com/s?k=The+Hunger+Games&i=audible&ref=x_gr_bb_audible&tag=x_gr_bb_audible-20"
        },
        {
            "name": "Barnes & Noble",
            "type": "store",
            "url": "https://www.barnesandnoble.com/w/?ean=9780439023481"
        },
        {
            "name": "AbeBooks",
            "type": "store",
            "url": "http://affiliates.abebooks.com/c/64613/77416/2029?u=http%3A%2F%2Fwww.abebooks.com%2Fservlet%2FSearchResults%3Fisbn%3D0439023483"
        },
        {
            "name": "Kobo",
            "type": "store",
            "url": "https://click.linksynergy.com/fs-bin/click?id=GwEz7vxblVU&subid=&offerid=361251.1&type=10&tmpid=9309&u1=x_gr_w_bb&RD_PARM1=https%3A%2F%2Fwww.kobo.com%2Fus%2Fen%2Fsearch%3FQuery%3DThe+Hunger+Games"
        },
        {
            "name": "Apple Books",
            "type": "store",
            "url": "https://geo.itunes.apple.com/us/book/isbn9780439023481?at=11lvdC&mt=11&ls=1"
        },
        {
            "name": "Google Play",
            "type": "store",
            "url": "https://play.google.com/store/search?q=9780439023481&c=books&PCamrefID=bookpage&PAffiliateID=10lHMS"
        },
        {
            "name": "Alibris",
            "type": "store",
            "url": "http://click.linksynergy.com/fs-bin/click?id=GwEz7vxblVU&subid=&offerid=189673.1&type=10&tmpid=939&&u1=x_gr_w_bb&RD_PARM1=http%3A%2F%2Fwww.alibris.com%2Fbooksearch%3Fkeyword%3D0439023483"
        },
        {
            "name": "Indigo",
            "type": "store",
            "url": "https://www.chapters.indigo.ca/en-ca/home/search/?keywords=9780439023481"
        },
        {
            "name": "Better World Books",
            "type": "store",
            "url": "http://www.tkqlhce.com/ob117vpyvpxCFFFKMHLCEDHLGHKECEFMIGDFFHJDDD?url=http%3A%2F%2Fwww.betterworldbooks.com%2FThe+Hunger+Games-H0.aspx%3FSearchTerm%3D0439023483"
        },
        {
            "name": "IndieBound",
            "type": "store",
            "url": "https://www.indiebound.org/book/9780439023481"
        },
        {
            "name": "Thriftbooks",
            "type": "store",
            "url": "https://thriftbooks.sjv.io/c/64613/4051236/58330?u=https%3A%2F%2Fwww.thriftbooks.com%2Fbrowse%2F%3Fb.search%3D0439023483"
        }
    ],
    "avgRating": 4.36,
    "totalRatings": 10365797,
    "totalReviews": 282376,
    "currentlyReading": 118196,
    "wantToRead": 1977036,
    "ratingsDistribution": {
        "oneStar": 135002,
        "twoStars": 244246,
        "threeStars": 1126818,
        "fourStars": 3148093,
        "fiveStars": 5711638
    }
}
通过ISBN获取书籍详情 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14964/goodreads+books+api/39238/book+details+by+isbn?isbn=9780439023481' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回与给定书籍类似的书籍
Endpoint ID: 39239
GET https://zylalabs.com/api/14964/goodreads+books+api/39239/similar+books
输入参数

类似的书籍 — 端点功能

对象 描述
workId 必需 Work id of the book. A work groups all editions of a book and has its own id, different from the book id. Both /v1/book and /v1/search/books return it.

剩余免费测试请求:3 / 3。


输入参数

workId
API 示例响应
JSON
[
    {
        "id": 42844155,
        "name": "Harry Potter and the Philosopher's Stone",
        "slug": "harry-potter-and-the-philosopher-s-stone",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1598823299i/42844155.jpg",
        "author": {
            "id": 1077326,
            "name": "J.K. Rowling",
            "slug": "J_K_Rowling"
        },
        "pages": 333,
        "avgRating": 4.44,
        "totalRatings": 2295813,
        "description": "An alternative cover for this ASIN can be found here\n\n\"Turning the envelope over, his hand trembling, Harry saw a purple wax seal bearing a coat of arms; a lion, an eagle, a badger and a snake surrounding a large letter 'H'.\"\n\nHarry Potter has never even heard of Hogwarts when the letters start dropping on the doormat at number four, Privet Drive. Addressed in green ink on yellowish parchment with a purple seal, they are swiftly confiscated by his grisly aunt and uncle. Then, on Harry's eleventh birthday, a great beetle-eyed giant of a man called Rubeus Hagrid bursts in with some astonishing news: Harry Potter is a wizard, and he has a place at Hogwarts School of Witchcraft and Wizardry. An incredible adventure is about to begin!"
    },
    {
        "id": 41865,
        "name": "Twilight",
        "slug": "Twilight",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1700522826i/41865.jpg",
        "author": {
            "id": 941441,
            "name": "Stephenie Meyer",
            "slug": "Stephenie_Meyer"
        },
        "pages": 498,
        "avgRating": 3.68,
        "totalRatings": 7405732,
        "description": "About three things I was absolutely positive.\n\nFirst, Edward was a vampire.\n\nSecond, there was a part of him - and I didn't know how dominant that part might be - that thirsted for my blood.\n\nAnd third, I was unconditionally and irrevocably in love with him.\n\nDeeply seductive and extraordinarily suspenseful, Twilight is a love story with bite."
    },
    {
        "id": 13335037,
        "name": "Divergent",
        "slug": "divergent",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1618526890i/13335037.jpg",
        "author": {
            "id": 4039811,
            "name": "Veronica Roth",
            "slug": "Veronica_Roth"
        },
        "pages": 487,
        "avgRating": 4.12,
        "totalRatings": 4104893,
        "description": "In Beatrice Prior’s dystopian Chicago world, society is divided into five factions, each dedicated to the cultivation of a particular virtue: Candor (the honest), Abnegation (the selfless), Dauntless (the brave), Amity (the peaceful), and Erudite (the intelligent). On an appointed day of every year, all sixteen-year-olds must select the faction to which they will devote the rest of their lives. For Beatrice, the decision is between staying with her family and being who she really is, she can’t have both. So she makes a choice that surprises everyone, including herself.\n\nDuring the highly competitive initiation that follows, Beatrice renames herself Tris, and struggles alongside her fellow initiates to live out the choice they have made. Together, they must undergo extreme physical tests of endurance and intense psychological simulations, some with devastating consequences. As initiation transforms them all, Tris must determine who her friends really are, and where, exactly, a romance with a sometimes-fascinating, sometimes-exasperating boy fits into the life she’s chosen.\n\nBut Tris also has a secret: one she’s kept hidden from everyone, because she’s been warned it can mean death. And as she discovers unrest and growing conflict that threatens to unravel her seemingly-perfect society, she also learns that her secret might be what helps her save those she loves...or it might be what destroys her.\n."
    },
    {
        "id": 25856606,
        "name": "The Fault in Our Stars",
        "slug": "the-fault-in-our-stars",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1436142804i/25856606.jpg",
        "author": {
            "id": 1406384,
            "name": "John  Green",
            "slug": "John_Green"
        },
        "pages": 313,
        "avgRating": 4,
        "totalRatings": 584169,
        "description": "Despite the tumor-shrinking medical miracle that has bought her a few years, Hazel has never been anything but terminal, her final chapter inscribed upon diagnosis. But when a gorgeous plot twist named Augustus Waters suddenly appears at Cancer Kid Support Group, Hazel's story is about to be completely rewritten.\n\nInsightful, bold, irreverent, and raw, The Fault in Our Stars is award-winning author John Green's most ambitious and heartbreaking work yet, brilliantly exploring the funny, thrilling, and tragic business of being alive and in love."
    },
    {
        "id": 56916837,
        "name": "To Kill a Mockingbird",
        "slug": "to-kill-a-mockingbird",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1612238791i/56916837.jpg",
        "author": {
            "id": 1825,
            "name": "Harper Lee",
            "slug": "Harper_Lee"
        },
        "pages": 323,
        "avgRating": 4.22,
        "totalRatings": 745729,
        "description": "One of the best-loved stories of all time, To Kill a Mockingbird has been translated into more than forty languages, sold more than forty million copies worldwide, served as the basis for an enormously popular motion picture, and was voted one of the best novels of the twentieth century by librarians across the country. A gripping, heart-wrenching, and wholly remarkable coming-of-age tale in a South poisoned by virulent prejudice, it views a world of great beauty and savage iniquities through the eyes of a young girl, as her father — a crusading local lawyer — risks everything to defend a black man unjustly accused of a terrible crime."
    },
    {
        "id": 123675190,
        "name": "The Lightning Thief",
        "slug": "the-lightning-thief",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1684776677i/123675190.jpg",
        "author": {
            "id": 15872,
            "name": "Rick Riordan",
            "slug": "Rick_Riordan"
        },
        "pages": 416,
        "avgRating": 4.35,
        "totalRatings": 383024,
        "description": "The first book in the New York Times best-selling saga with a cover image and an 8-page photo insert from the Disney+ series!\n\nRead the book that launched Percy Jackson into the stratosphere before the Disney+ series comes out!\n\nLately, mythological monsters and the Olympian gods seem to be walking straight out of the pages of Percy Jackson’s Greek mythology textbook and into his life. Zeus's master lightning bolt has been stolen, and Percy is the prime suspect. Percy and his friends have just ten days to find and return Zeus's stolen property and bring peace to a warring Mount Olympus. \n\nWhether you are new to Percy or a longtime fan, this tie-in paperback edition with full-color photos from the Disney+ series is a must-have for your library."
    },
    {
        "id": 6186357,
        "name": "The Maze Runner",
        "slug": "the-maze-runner",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1375596592i/6186357.jpg",
        "author": {
            "id": 348878,
            "name": "James Dashner",
            "slug": "James_Dashner"
        },
        "pages": 384,
        "avgRating": 4.06,
        "totalRatings": 1634527,
        "description": "There are alternate cover editions for this ASIN here and here.\n\nIf you ain’t scared, you ain’t human.\n \nWhen Thomas wakes up in the lift, the only thing he can remember is his name. He’s surrounded by strangers—boys whose memories are also gone.\n \nNice to meet ya, shank. Welcome to the Glade.\n \nOutside the towering stone walls that surround the Glade is a limitless, ever-changing maze. It’s the only way out—and no one’s ever made it through alive.\n \nEverything is going to change.\n \nThen a girl arrives. The first girl ever. And the message she delivers is terrifying.\n \nRemember. Survive. Run."
    },
    {
        "id": 41733839,
        "name": "The Great Gatsby",
        "slug": "the-great-gatsby",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1650033243i/41733839.jpg",
        "author": {
            "id": 3190,
            "name": "F. Scott Fitzgerald",
            "slug": "F_Scott_Fitzgerald"
        },
        "pages": 180,
        "avgRating": 3.94,
        "totalRatings": 704646
    },
    {
        "_note": "Response truncated for documentation purposes"
    }
]
类似的书籍 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14964/goodreads+books+api/39239/similar+books?workId=2792775' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回单个系列的详细信息以及其按阅读顺序排列的书籍 每本书都标明其在系列中的位置(例如“第1本”)主要作品优先考虑,其次是剩余作品
Endpoint ID: 39240
GET https://zylalabs.com/api/14964/goodreads+books+api/39240/series+details
输入参数

系列详情 — 端点功能

对象 描述
id 必需 Series id. The /v1/book endpoint returns the series ids of a book.
page 可选 Page number, starting from 1 (defaults to 1). Only long series are split into pages.

剩余免费测试请求:3 / 3。


输入参数

id
page
API 示例响应
JSON
{
    "id": 45175,
    "name": "Harry Potter",
    "description": "Orphan Harry learns he is a wizard on his 11th birthday when Hagrid escorts him to magic-teaching Hogwarts School. As a baby, his mother's love protected him and vanquished the villain Voldemort, leaving the child famous as \"The Boy who Lived.\" With his friends Hermione and Ron, Harry has to defeat the returned \"He Who Must Not Be Named.\"",
    "primaryWorks": 7,
    "totalWorks": 10,
    "page": 1,
    "totalPages": 1,
    "books": [
        {
            "position": "Book 0.5",
            "id": 8933944,
            "name": "Harry Potter: The Prequel",
            "slug": "harry-potter",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1456894457i/8933944.jpg",
            "author": {
                "id": 1077326,
                "name": "J.K. Rowling",
                "slug": "J_K_Rowling"
            },
            "pages": 3,
            "avgRating": 4.07,
            "totalRatings": 28565,
            "description": "The Harry Potter prequel is an 800-word story written by J. K. Rowling, and was published online on 11 June 2008. Set about three years before the birth of Harry Potter, the story recounts an adventure experienced by Sirius Black and James Potter.\n\nAt the bottom of the card, JKR wrote: \"From the prequel I am NOT working on - but that was fun!\""
        },
        {
            "position": "Book 1",
            "id": 42844155,
            "name": "Harry Potter and the Philosopher's Stone",
            "slug": "harry-potter-and-the-philosopher-s-stone",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1598823299i/42844155.jpg",
            "author": {
                "id": 1077326,
                "name": "J.K. Rowling",
                "slug": "J_K_Rowling"
            },
            "pages": 333,
            "avgRating": 4.47,
            "totalRatings": 11915078,
            "description": "An alternative cover for this ASIN can be found here\n\n\"Turning the envelope over, his hand trembling, Harry saw a purple wax seal bearing a coat of arms; a lion, an eagle, a badger and a snake surrounding a large letter 'H'.\"\n\nHarry Potter has never even heard of Hogwarts when the letters start dropping on the doormat at number four, Privet Drive. Addressed in green ink on yellowish parchment with a purple seal, they are swiftly confiscated by his grisly aunt and uncle. Then, on Harry's eleventh birthday, a great beetle-eyed giant of a man called Rubeus Hagrid bursts in with some astonishing news: Harry Potter is a wizard, and he has a place at Hogwarts School of Witchcraft and Wizardry. An incredible adventure is about to begin!"
        },
        {
            "position": "Book 1.5",
            "id": 209269064,
            "name": "Christmas at Hogwarts",
            "slug": "christmas-at-hogwarts",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1718903529i/209269064.jpg",
            "author": {
                "id": 1077326,
                "name": "J.K. Rowling",
                "slug": "J_K_Rowling"
            },
            "pages": 40,
            "avgRating": 4.49,
            "totalRatings": 6016,
            "description": "From J.K. Rowling’s Harry Potter and the Sorcerer’s Stone, the story of Harry Potter’s first Christmas at Hogwarts, joyfully illustrated in a heartwarming picture book sure to delight readers of all ages!\n“Christmas was coming. One morning in mid-December, Hogwarts woke to find itself covered in several feet of snow.”\n\nSo begins Chapter Twelve of Harry Potter and the Sorcerer’s Stone, and the heartwarming story of Harry Potter’s first Christmas at Hogwarts. From the Great Hall decked with magnificent fir trees to cozy evenings in the Gryffindor Common Room to the joy of presents on Christmas morning, it’s a holiday filled with warmth, friendship, good food, and magical surprises that Harry will never forget.\n\nWith text drawn directly from J.K. Rowling’s Harry Potter and the Sorcerer’s Stone and luminous illustrations by artist Ziyi Gao, this favorite moment from one of the most beloved books of all time is now fully illustrated for the whole family to enjoy. Sure to be treasured by Harry Potter fans of all ages, Christmas at Hogwarts is the perfect gift, destined to become an enchanting new holiday tradition."
        },
        {
            "position": "Book 2",
            "id": 239754337,
            "name": "Harry Potter and the Chamber of Secrets",
            "slug": "harry-potter-and-the-chamber-of-secrets",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1791230627i/239754337.jpg",
            "author": {
                "id": 1077326,
                "name": "J.K. Rowling",
                "slug": "J_K_Rowling"
            },
            "pages": 10,
            "avgRating": 4.43,
            "totalRatings": 4713077,
            "description": "The beloved stories as you’ve never experienced them. Get ready to be transported to the world of Harry Potter in a captivating production that features hundreds of unique voices and immersive sound design that brings the wizarding world vividly to life in Dolby Atmos. You’ll hear footsteps echoing through the corridors of Hogwarts and the heart-racing whoosh of the Golden Snitch as it darts past your ears in the heat of a Quidditch match. Also featuring an electrifying new musical score, The Full-Cast Audio Editions present J.K. Rowling’s iconic series as a truly spellbinding listening event for the whole family.\n\n'There is a plot, Harry Potter. A plot to make most terrible things happen at Hogwarts School of Witchcraft and Wizardry this year.'\n\nHarry Potter's summer has included the worst birthday ever, doomy warnings from a house-elf called Dobby, and rescue from the Dursleys by his friend Ron Weasley in a magical flying car! Back at Hogwarts School of Witchcraft and Wizardry for his second year, Harry hears strange whispers echo through empty corridors—and then the attacks start. Students are found as though turned to stone... Dobby's sinister predictions seem to be coming true.\n\nHaving become classics of our time, the Harry Potter stories never fail to bring comfort and escapism. With their message of hope, belonging and the enduring power of truth and love, the story of the Boy Who Lived continues to delight generations of new listeners.\n\nAvailable in Dolby Atmos on Audible."
        },
        {
            "position": "Book 3",
            "id": 5,
            "name": "Harry Potter and the Prisoner of Azkaban",
            "slug": "Harry_Potter_and_the_Prisoner_of_Azkaban",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1630547330i/5.jpg",
            "author": {
                "id": 1077326,
                "name": "J.K. Rowling",
                "slug": "J_K_Rowling"
            },
            "pages": 547,
            "avgRating": 4.58,
            "totalRatings": 5095624,
            "description": "Harry Potter, along with his best friends, Ron and Hermione, is about to start his third year at Hogwarts School of Witchcraft and Wizardry. Harry can't wait to get back to school after the summer holidays. (Who wouldn't if they lived with the horrible Dursleys?) But when Harry gets to Hogwarts, the atmosphere is tense. There's an escaped mass murderer on the loose, and the sinister prison guards of Azkaban have been called in to guard the school..."
        },
        {
            "position": "Book 4",
            "id": 58613424,
            "name": "Harry Potter and the Goblet of Fire",
            "slug": "harry-potter-and-the-goblet-of-fire",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1627044952i/58613424.jpg",
            "author": {
                "id": 1077326,
                "name": "J.K. Rowling",
                "slug": "J_K_Rowling"
            },
            "pages": 752,
            "avgRating": 4.56,
            "totalRatings": 4392464
        }
    ],
    "_note": "Response truncated for documentation purposes"
}
系列详情 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14964/goodreads+books+api/39240/series+details?id=45175&page=1' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回Goodreads类别以及分页信息
Endpoint ID: 39241
GET https://zylalabs.com/api/14964/goodreads+books+api/39241/genres
输入参数

类型 — 端点功能

对象 描述
page 可选 Page number, starting from 1 (defaults to 1).
top-level-only 可选 Set to "true" to only return top-level genres (defaults to false).

剩余免费测试请求:3 / 3。


输入参数

page
top-level-only
API 示例响应
JSON
{
    "page": 1,
    "totalPages": 4,
    "genres": [
        {
            "name": "40k",
            "slug": "40k",
            "books": 26459
        },
        {
            "name": "Aapi",
            "slug": "aapi",
            "books": 19412
        },
        {
            "name": "Addiction",
            "slug": "addiction",
            "books": 42532
        },
        {
            "name": "Adolescence",
            "slug": "adolescence",
            "books": 16470
        },
        {
            "name": "Adult",
            "slug": "adult",
            "books": 2444813
        },
        {
            "name": "Adventure Romance",
            "slug": "adventure-romance",
            "books": 2659
        },
        {
            "name": "Aeroplanes",
            "slug": "aeroplanes",
            "books": 105
        },
        {
            "name": "Agatha Christie",
            "slug": "agatha-christie",
            "books": 179134
        },
        {
            "name": "Age Gap Romance",
            "slug": "age-gap-romance",
            "books": 21960
        },
        {
            "name": "Aging",
            "slug": "aging",
            "books": 15001
        },
        {
            "name": "Amish",
            "slug": "amish",
            "books": 51959
        },
        {
            "name": "Angels And Demons",
            "slug": "angels-and-demons",
            "books": 26601
        },
        {
            "name": "Animals",
            "slug": "animals",
            "books": 593523
        },
        {
            "name": "Animation",
            "slug": "animation",
            "books": 7335
        },
        {
            "name": "Anthologies",
            "slug": "anthologies",
            "books": 150106
        },
        {
            "name": "Anti Hero",
            "slug": "anti-hero",
            "books": 42338
        },
        {
            "name": "Art And Photography",
            "slug": "art-and-photography",
            "books": 7041
        },
        {
            "name": "Artificial Intelligence",
            "slug": "artificial-intelligence",
            "books": 26519
        },
        {
            "name": "Asian American",
            "slug": "asian-american",
            "books": 23559
        },
        {
            "name": "Audiobook",
            "slug": "audiobook",
            "books": 6064374
        },
        {
            "name": "Aviation",
            "slug": "aviation",
            "books": 24621
        },
        {
            "name": "Baseball Romance",
            "slug": "baseball-romance",
            "books": 3910
        },
        {
            "name": "Beach Reads",
            "slug": "beach-reads",
            "books": 63004
        },
        {
            "name": "Behind The Scenes",
            "slug": "behind-the-scenes",
            "books": 1753
        },
        {
            "name": "Biblical",
            "slug": "biblical",
            "books": 13981
        },
        {
            "name": "Billionaire Romance",
            "slug": "billionaire-romance",
            "books": 48512
        },
        {
            "name": "Billionaires",
            "slug": "billionaires",
            "books": 30661
        },
        {
            "name": "Biographical Fiction",
            "slug": "biographical-fiction",
            "books": 7277
        },
        {
            "name": "Biography Memoir",
            "slug": "biography-memoir",
            "books": 359233
        },
        {
            "name": "Bird Watching",
            "slug": "bird-watching",
            "books": 210
        },
        {
            "name": "Black Author",
            "slug": "black-author",
            "books": 27725
        },
        {
            "name": "Black Women",
            "slug": "black-women",
            "books": 3774
        },
        {
            "name": "Boating",
            "slug": "boating",
            "books": 536
        },
        {
            "name": "Bodyguard Romance",
            "slug": "bodyguard-romance",
            "books": 4619
        },
        {
            "name": "Book To Screen",
            "slug": "book-to-screen",
            "books": 20396
        },
        {
            "name": "Booktok",
            "slug": "booktok",
            "books": 184596
        },
        {
            "name": "Bret Easton Ellis",
            "slug": "bret-easton-ellis",
            "books": 576
        },
        {
            "name": "British Royalty",
            "slug": "british-royalty",
            "books": 1084
        },
        {
            "name": "Canon",
            "slug": "canon",
            "books": 31579
        },
        {
            "name": "Celebrity",
            "slug": "celebrity",
            "books": 49747
        },
        {
            "name": "Character Drama",
            "slug": "character-drama",
            "books": 214
        },
        {
            "name": "Children S Mystery",
            "slug": "children-s-mystery",
            "books": 1098
        },
        {
            "name": "Childrens Adventure",
            "slug": "childrens-adventure",
            "books": 1330
        },
        {
            "name": "Childrens Fantasy",
            "slug": "childrens-fantasy",
            "books": 14295
        },
        {
            "name": "Childrens Mystery",
            "slug": "childrens-mystery",
            "books": 2387
        },
        {
            "name": "Childrens Self Esteem",
            "slug": "childrens-self-esteem",
            "books": 80
        },
        {
            "name": "Chosen Family",
            "slug": "chosen-family",
            "books": 3332
        },
        {
            "name": "Christian",
            "slug": "christian",
            "books": 767290
        },
        {
            "name": "Christmas Romance",
            "slug": "christmas-romance",
            "books": 16723
        },
        {
            "name": "Cia",
            "slug": "cia",
            "books": 5488
        },
        {
            "name": "Closed Door Romance",
            "slug": "closed-door-romance",
            "books": 9959
        },
        {
            "name": "Coast Guard",
            "slug": "coast-guard",
            "books": 350
        },
        {
            "name": "Colleen Hoover",
            "slug": "colleen-hoover",
            "books": 50319
        },
        {
            "name": "College Romance",
            "slug": "college-romance",
            "books": 69444
        },
        {
            "name": "Colouring Books",
            "slug": "colouring-books",
            "books": 2600
        },
        {
            "name": "Comics Manga",
            "slug": "comics-manga",
            "books": 109234
        },
        {
            "name": "Coming Of Age Drama",
            "slug": "coming-of-age-drama",
            "books": 255
        },
        {
            "name": "Coming Of Middle Age",
            "slug": "coming-of-middle-age",
            "books": 16
        },
        {
            "name": "Complex Female Characters",
            "slug": "complex-female-characters",
            "books": 594
        },
        {
            "name": "Conservation",
            "slug": "conservation",
            "books": 9287
        },
        {
            "name": "Conspiracy Thriller",
            "slug": "conspiracy-thriller",
            "books": 1666
        },
        {
            "name": "Construction",
            "slug": "construction",
            "books": 6829
        },
        {
            "name": "Court Intrigue",
            "slug": "court-intrigue",
            "books": 4628
        },
        {
            "name": "Courtroom Drama",
            "slug": "courtroom-drama",
            "books": 3582
        },
        {
            "name": "Cowboy Romance",
            "slug": "cowboy-romance",
            "books": 29816
        },
        {
            "name": "Cozy",
            "slug": "cozy",
            "books": 262755
        },
        {
            "name": "Cozy Fantasy",
            "slug": "cozy-fantasy",
            "books": 47261
        },
        {
            "name": "Cozy Romance",
            "slug": "cozy-romance",
            "books": 6741
        },
        {
            "name": "Creative",
            "slug": "creative",
            "books": 14522
        },
        {
            "name": "Cry",
            "slug": "cry",
            "books": 6630
        },
        {
            "name": "Cs Lewis",
            "slug": "cs-lewis",
            "books": 6814
        },
        {
            "name": "Dark",
            "slug": "dark",
            "books": 777503
        },
        {
            "name": "Dark Academia",
            "slug": "dark-academia",
            "books": 173470
        },
        {
            "name": "Dark Comedy",
            "slug": "dark-comedy",
            "books": 5120
        },
        {
            "name": "Dark Humor",
            "slug": "dark-humor",
            "books": 9807
        },
        {
            "name": "Dark Romance",
            "slug": "dark-romance",
            "books": 1032221
        },
        {
            "name": "Death",
            "slug": "death",
            "books": 209706
        },
        {
            "name": "Devotional",
            "slug": "devotional",
            "books": 32382
        },
        {
            "name": "Diary"
        }
    ],
    "_note": "Response truncated for documentation purposes"
}
类型 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14964/goodreads+books+api/39241/genres?page=1&top-level-only=true' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回有关单个类型的详细信息,包括相关类型
Endpoint ID: 39242
GET https://zylalabs.com/api/14964/goodreads+books+api/39242/genre+details
输入参数

类型细节 — 端点功能

对象 描述
slug 必需 Genre slug. Use /v1/genres to list valid values.

剩余免费测试请求:3 / 3。


输入参数

slug
API 示例响应
JSON
{
    "name": "Nonfiction",
    "slug": "non-fiction",
    "description": "Nonfiction is an account or representation of a subject which is presented as fact. This presentation may be accurate or not; that is, it can give either a true or a false account of the subject in question. However, it is generally assumed that the authors of such accounts believe them to be truthful at the time of their composition. Note that reporting the beliefs of others in a nonfiction format is not necessarily an endorsement of the ultimate veracity of those beliefs, it is simply saying that it is true that people believe that (for such topics as mythology, religion). Nonfiction can also be written about fiction, giving information about these other works.\n\nNonfiction is one of the two main divisions in writing, particularly used in libraries, the other being fiction. However, nonfiction need not be written text necessarily, since pictures and film can also purport to present a factual account of a subject.",
    "relatedGenres": [
        {
            "name": "History",
            "slug": "history"
        },
        {
            "name": "Philosophy",
            "slug": "philosophy"
        },
        {
            "name": "Biography",
            "slug": "biography"
        },
        {
            "name": "Science",
            "slug": "science"
        },
        {
            "name": "Psychology",
            "slug": "psychology"
        },
        {
            "name": "Politics",
            "slug": "politics"
        },
        {
            "name": "Self Help",
            "slug": "self-help"
        },
        {
            "name": "Business",
            "slug": "business"
        },
        {
            "name": "Religion",
            "slug": "religion"
        },
        {
            "name": "Art",
            "slug": "art"
        },
        {
            "name": "Cookbooks",
            "slug": "cookbooks"
        },
        {
            "name": "Reference",
            "slug": "reference"
        },
        {
            "name": "Travel",
            "slug": "travel"
        },
        {
            "name": "Music",
            "slug": "music"
        },
        {
            "name": "Economics",
            "slug": "economics"
        },
        {
            "name": "Spirituality",
            "slug": "spirituality"
        },
        {
            "name": "Parenting",
            "slug": "parenting"
        },
        {
            "name": "Health",
            "slug": "health"
        },
        {
            "name": "Education",
            "slug": "education"
        },
        {
            "name": "Sociology",
            "slug": "sociology"
        },
        {
            "name": "Christianity",
            "slug": "christianity"
        },
        {
            "name": "Leadership",
            "slug": "leadership"
        },
        {
            "name": "Design",
            "slug": "design"
        },
        {
            "name": "Anthropology",
            "slug": "anthropology"
        },
        {
            "name": "Academic",
            "slug": "academic"
        },
        {
            "name": "Cultural",
            "slug": "cultural"
        },
        {
            "name": "Architecture",
            "slug": "architecture"
        },
        {
            "name": "Environment",
            "slug": "environment"
        },
        {
            "name": "Marriage",
            "slug": "marriage"
        },
        {
            "name": "Social Issues",
            "slug": "social-issues"
        },
        {
            "name": "Law",
            "slug": "law"
        },
        {
            "name": "Gardening",
            "slug": "gardening"
        },
        {
            "name": "Folklore",
            "slug": "folklore"
        },
        {
            "name": "Social Science",
            "slug": "social-science"
        },
        {
            "name": "Crafts",
            "slug": "crafts"
        },
        {
            "name": "How To",
            "slug": "how-to"
        },
        {
            "name": "Criticism",
            "slug": "criticism"
        },
        {
            "name": "Food and Drink",
            "slug": "food-and-drink"
        },
        {
            "name": "True Story",
            "slug": "true-story"
        },
        {
            "name": "Humanities",
            "slug": "humanities"
        },
        {
            "name": "Labor",
            "slug": "labor"
        },
        {
            "name": "Religión",
            "slug": "religión"
        },
        {
            "name": "Sports and Games",
            "slug": "sports-and-games"
        },
        {
            "name": "Éducation",
            "slug": "éducation"
        },
        {
            "name": "Référence",
            "slug": "référence"
        },
        {
            "name": "Art",
            "slug": "art"
        },
        {
            "name": "Polítics",
            "slug": "polítics"
        },
        {
            "name": "Économics",
            "slug": "économics"
        },
        {
            "name": "Hìstory",
            "slug": "hìstory"
        },
        {
            "name": "Scieñce",
            "slug": "scieñce"
        },
        {
            "name": "Travél",
            "slug": "travél"
        },
        {
            "name": "Acadêmic",
            "slug": "acadêmic"
        },
        {
            "name": "Acadèmic",
            "slug": "acadèmic"
        },
        {
            "name": "Biograpĥy",
            "slug": "biograpĥy"
        },
        {
            "name": "Sciençe",
            "slug": "sciençe"
        },
        {
            "name": "Phílosophy",
            "slug": "phílosophy"
        },
        {
            "name": "Désign",
            "slug": "désign"
        },
        {
            "name": "Relígion",
            "slug": "relígion"
        },
        {
            "name": "Músic",
            "slug": "músic"
        },
        {
            "name": "Edùcation",
            "slug": "edùcation"
        },
        {
            "name": "Hiśtory",
            "slug": "hiśtory"
        }
    ]
}
类型细节 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14964/goodreads+books+api/39242/genre+details?slug=non-fiction' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回新发行的书籍在一个类别中
Endpoint ID: 39243
GET https://zylalabs.com/api/14964/goodreads+books+api/39243/genre+new+releases
输入参数

类型新发行 — 端点功能

对象 描述
slug 必需 Genre slug. Use /v1/genres to list valid values.

剩余免费测试请求:3 / 3。


输入参数

slug
API 示例响应
JSON
[
    {
        "id": 247150129,
        "name": "Vibe: The Secrets of Strong Connections in a Lonely World",
        "slug": "vibe",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1772514974l/247150129.jpg",
        "author": {
            "id": 6583155,
            "name": "Adam Grant",
            "slug": "Adam_Grant"
        },
        "publishedYear": 2026,
        "avgRating": 4.06,
        "totalRatings": 1980,
        "description": "#1 New York Times bestselling author Adam Grant illuminates the surprising science of chemistry and closeness. \n\nWhen we vibe with other people, it fuels our happiness and success. Yet building meaningful ties is one of the most pressing problems of our time. As face-to-face interaction gives way to digital screens, communication gets outsourced to AI and the world becomes more polarised, our loneliness crisis shows no signs of slowing.\n\nTo reveal how we can forge faster, stronger and longer bonds, Adam Grant offers groundbreaking studies, expert insights and myth-busting stories. Filled with the eyeopening takeaways that have brought millions of readers to his books, Vibe teaches us that similarity is not necessary for solidarity, chemistry doesn’t always happen quickly and closeness doesn’t always take time.\n\nAlong the way, Grant introduces us to a crew of astronauts who learned to trust people they don’t like, a comedy troupe that swears by taking time apart as a key to staying together, a band that grew closer by learning to fight more and a journalist who designed a gathering that led to 78 marriages. He also opens up about his personal struggles to find his place as a shy introvert and the lessons that propelled his transformation into an enthusiastic convenor. Through these examples and more, Grant uncovers the keys to creating deeper relationships and tighter communities.\n\nVibe will change how you interact with people. No matter how good you are at connecting, you can always get better – and help others get better too."
    },
    {
        "id": 246235272,
        "name": "The Rush: California Gold, the Civil War, and the Making of the Modern World",
        "slug": "the-rush",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1771045347l/246235272.jpg",
        "author": {
            "id": 1641,
            "name": "Nathaniel Philbrick",
            "slug": "Nathaniel_Philbrick"
        },
        "publishedYear": 2026,
        "avgRating": 4.04,
        "totalRatings": 802,
        "description": "NEW YORK TIMES BESTSELLER · A New York Times Most Anticipated Nonfiction Book of 2026 · A Los Angeles Times Best Book of the Fall National Book Award winner and Pulitzer Prize finalist Nathaniel Philbrick, author of In the Heart of the Sea and Mayflower, reveals how California’s Gold Rush forged the modern United States—and lit the long fuse to civil warIn January 1848, a carpenter spotted flecks of gold in a shallow stream at Sutter’s Mill in California, triggering the greatest voluntary migration in U.S. history, as hundreds of thousands raced west in pursuit of sudden wealth, reinvention, and power. From the feverish gold-mining camps of the Sierra Nevada mountains to the wharves and vigilance committees of San Francisco, Nathaniel Philbrick renders a combustible, all-world Chilean brothers reinventing themselves to outrun prejudice; Native communities navigating dispossession and violence; the merchant-showman Samuel Brannan, drawn into the center of early vigilantism; and the politicians vying for control of California’s future—the ambitious Free-Soil political boss David Broderick, who squared off against William Gwin, the Southern power broker intent on tilting the state toward slavery and the Confederacy.In The Rush, Nathaniel Philbrick transforms the Gold Rush from a tale of sudden riches into the origin story of America’s modern contradictions—capital consolidated at dizzying speed, democracy in thrall to private power, xenophobia weaponized in the name of liberty—and a stubborn belief in the American experiment that refuses to die. This is the story of a nation tearing at the seams and a republic tested by its own ideals. Not until ayear after the outbreak of the Civil War, when President Lincoln signed legislation that would unite the nation east to west by building a transcontinental railroad, was California’s loyalty secured.Philbrick follows the gold as it moves from riverbed to countinghouse to the halls of power, revealing how vigilantism hardened into law and how debates over slavery in the West tipped the balance in Washington. The result is a clear, human story of how a scramble for wealth reshaped ideas of freedom, labor, and belonging—and how California's rise helped push a fractured nation toward war. The Rush is alive with characters whose choices still a searing, panoramic epic that captures both the fury and the promise of America."
    },
    {
        "id": 247476700,
        "name": "Plot Twist: Life, Craft, and the Messy First Draft: A Memoir on Writing",
        "slug": "plot-twist",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1778608298l/247476700.jpg",
        "author": {
            "id": 24689,
            "name": "Harlan Coben",
            "slug": "Harlan_Coben"
        },
        "publishedYear": 2026,
        "avgRating": 4.3,
        "totalRatings": 1070,
        "description": "#1 New York Times bestselling author Harlan Coben offers a look behind the curtain at his own writing process in an inspiring, candid memoir filled with indispensable insights and techniques. With 100 million books in print world-wide and over a dozen blockbuster television and film adapations of his work, Harlan Coben has much to teach us about the creative process. Part deeply personal memoir, part masterclass in storytelling, Plot Twist is a refreshingly honest look at the life of a writer whose stories have thrilled us for decades.\n\nPlumbing memories from his suburban childhood and his early years trying to break into publishing, Coben tells his own story for the first time, revealing the real-world inspirations for some of his most beloved characters as well as the innovative plots that drive his propulsive novels. Filled with useful tips and techniques on the creative process, Coben does away with the traditional \"categories\" of writing—characters, plot, setting, etc—and looks at the process holistically. Plot Twist is a masterclass on the act of being a writer, and everything that comes with it: the self‑doubt, the hubris, the contradictions, the passion and dedication. At the end of the day, his calculus is a simple one: “If it helps me produce pages, good. If it doesn’t, bad.” This book will help every aspiring writer produce pages. Honest, funny, insightful, and at times deeply moving, this is both a captivating memoir and an essential guide for anyone looking to master the art of storytelling from one of our most beloved authors."
    },
    {
        "id": 253690886,
        "name": "Rise After Silence: An ER Doctor and the Patients Who Healed Her",
        "slug": "rise-after-silence",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1781076402l/253690886.jpg",
        "author": {
            "id": 70700501,
            "name": "Anne Aspler",
            "slug": "Anne_Aspler"
        },
        "publishedYear": 2026,
        "avgRating": 4.56,
        "totalRatings": 256,
        "description": "At 5 a.m. in the emergency department, Dr. Anne Aspler is the physician treating patients in crisis. She collects forensic evidence from sexual assault survivors. She sets the shattered bones of domestic abuse victims. But beneath the white coat, she is wrestling with a crisis of her own.\n\n\nAnne's father is a convicted serial rapist. Her mother is lost to severe schizophrenia, hoarding, and the streets. Raised amid religious fundamentalism, foster care, and poverty, Anne ran in the opposite direction-eventually becoming a Harvard-trained doctor. To survive, she severed ties with her father, shed her faith, and built a pristine, controlled life.\n \n\nBut the ER is a mirror. When Anne treats women injured by their partners, or patients wrestling with PTSD and addiction, the boundary between doctor and patient collapses. Caring for them forces her to ask an impossible question: How will she explain her parents to her young daughters-and should they ever meet their grandfather?\n\n\nRise After Silence is a visceral, unsparing memoir about the collision of professional duty and deeply buried personal trauma. It is an exploration of how private violence never stays private. It compounds. It migrates. And it demands to be brought into the light. An unflinching look at what we inherit-and the fierce work of deciding what we pass on. "
    },
    {
        "id": 248337425,
        "name": "An American Girl: How a Billion-Dollar Doll and Its Unlikely Founder Changed Girlhood Forever",
        "slug": "an-american-girl",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1771767607l/248337425.jpg",
        "author": {
            "id": 35156072,
            "name": "Amanda FitzSimons",
            "slug": "Amanda_FitzSimons"
        },
        "publishedYear": 2026,
        "avgRating": 3.94,
        "totalRatings": 841
    },
    {
        "_note": "Response truncated for documentation purposes"
    }
]
类型新发行 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14964/goodreads+books+api/39243/genre+new+releases?slug=non-fiction' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回该类别中最受欢迎的书籍,包括它们的作者、评分、封面图像和出版细节
Endpoint ID: 39244
GET https://zylalabs.com/api/14964/goodreads+books+api/39244/genre+most+read+books
输入参数

最受欢迎的书籍类型 — 端点功能

对象 描述
slug 必需 Genre slug. Use /v1/genres to list valid values.

剩余免费测试请求:3 / 3。


输入参数

slug
API 示例响应
JSON
[
    {
        "id": 59366244,
        "name": "I'm Glad My Mom Died",
        "slug": "i-m-glad-my-mom-died",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1649228846l/59366244.jpg",
        "author": {
            "id": 15457334,
            "name": "Jennette McCurdy",
            "slug": "Jennette_McCurdy"
        },
        "publishedYear": 2022,
        "avgRating": 4.42,
        "totalRatings": 1651330,
        "description": "A heartbreaking and hilarious memoir by iCarly and Sam & Cat star Jennette McCurdy about her struggles as a former child actor—including eating disorders, addiction, and a complicated relationship with her overbearing mother—and how she retook control of her life.\n\nJennette McCurdy was six years old when she had her first acting audition. Her mother’s dream was for her only daughter to become a star, whatever it took, and Jennette would do anything to make her mother happy. So she went along with what her mother called “calorie restriction”, weighing herself five times a day and ultimately shrinking down to 89 pounds. She endured extensive at-home makeovers using knockoff whitening strips, hot curlers, eyelash tint, and gobs of bleach to enhance her “natural beauty.” She was showered by her mother until age sixteen while sharing her diaries, an email account, and all her earnings. The dream finally comes true when Jennette is cast in a new Nickelodeon series called iCarly and is thrust into fame. But for Jennette, the dream is a nightmare.\n\nPractically overnight, her fake smile and cheesy airbrushed hair-do is plastered on billboards across the country. And though her mom is ecstatic, ordering her to smile for the paparazzi (with whom she’s on a first-name basis) and sign endless autographs for fans who only know her by her character’s name, Jennette is riddled with anxiety, shame and self-loathing, which manifest into eating disorders, addiction and a series of unhealthy relationships. These issues only get worse when Jennette’s mother dies of cancer. Finally, after discovering therapy and coldly examining the relationship with her mother, Jennette embarks on recovery and decides for the first time in her life what she really wants. Told with raw honesty and equal parts gravity and humor, I’m Glad My Mom Died is a a shocking, devastating, and ultimately inspiring story of resilience."
    },
    {
        "id": 216351768,
        "name": "The Let Them Theory",
        "slug": "the-let-them-theory",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1735589383l/216351768.jpg",
        "author": {
            "id": 4470180,
            "name": "Mel Robbins",
            "slug": "Mel_Robbins"
        },
        "publishedYear": 2024,
        "avgRating": 3.98,
        "totalRatings": 367284,
        "description": "Learn how to stop wasting energy on what you can't control and start focusing on yourself.\n\nIf you've ever felt stuck, overwhelmed, or frustrated with where you are, the problem isn't you; the problem is the power you give to other people. Two simple words—\"Let Them\"—will set you free. Free from the opinions, drama, and judgments of others. Free from the exhausting cycle of trying to manage everything and everyone around you. \n\nThe Let Them Theory puts the power to create a life you love back in your hands. Written as an easy-to-understand guide, Mel Robbins shares relatable stories from her own life; highlights key takeaways and relevant research; and introduces you to world-renowned experts in psychology, neuroscience, relationships, happiness, and ancient wisdom who champion The Let Them Theory every step of the way."
    },
    {
        "id": 59903149,
        "name": "Strong Female Character",
        "slug": "strong-female-character",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1670358571l/59903149.jpg",
        "author": {
            "id": 30382951,
            "name": "Fern Brady",
            "slug": "Fern_Brady"
        },
        "publishedYear": 2023,
        "avgRating": 4.38,
        "totalRatings": 47185,
        "description": "A summary of my book:\n\n1. I'm diagnosed with autism 20 years after telling a doctor I had it.\n\n2. My terrible Catholic childhood.\n\n3. My friendship with an elderly man who runs the corner shop and is definitely not trying to groom me. I get groomed.\n\n4. Homelessness.\n\n5. Stripping.\n\n6. More stripping but with more nervous breakdowns.\n\n7. I hate everyone at uni and live with a psycho etc.\n\n8. REDACTED as too spicy.\n\n9. After everyone tells me I don't look autistic, I try to cure my autism and get addicted to Xanax.\n\n10. REDACTED as too embarrassing."
    },
    {
        "id": 62873378,
        "name": "The Art Thief: A True Story of Love, Crime, and a Dangerous Obsession",
        "slug": "the-art-thief",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1701688707l/62873378.jpg",
        "author": {
            "id": 206768,
            "name": "Michael Finkel",
            "slug": "Michael_Finkel"
        },
        "publishedYear": 2023,
        "avgRating": 3.91,
        "totalRatings": 131265,
        "description": "One of the most remarkable true-crime narratives of the twenty-first the story of the world’s most prolific art thief, Stéphane Breitwieser.In this spellbinding portrait of obsession and flawed genius, the best-selling author of The Stranger in the Woods brings us into Breitwieser’s strange world—unlike most thieves, he never stole for money, keeping all his treasures in a single room where he could admire them.For centuries, works of art have been stolen in countless ways from all over the world, but no one has been quite as successful at it as the master thief Stéphane Breitwieser. Carrying out more than two hundred heists over nearly eight years—in museums and cathedrals all over Europe—Breitwieser, along with his girlfriend who worked as his lookout, stole more than three hundred objects, until it all fell apart in spectacular fashion.In The Art Thief, Michael Finkel brings us into Breitwieser’s strange and fascinating world. Unlike most thieves, Breitwieser never stole for money. Instead, he displayed all his treasures in a pair of secret rooms where he could admire them to his heart’s content. Possessed of a remarkable athleticism and an innate ability to circumvent practically any security system, Breitwieser managed to pull off a breathtaking number of audacious thefts. Yet these strange talents bred a growing disregard for risk and an addict’s need to score, leading Breitwieser to ignore his girlfriend’s pleas to stop—until one final act of hubris brought everything crashing down.This is a riveting story of art, crime, love, and an insatiable hunger to possess beauty at any cost."
    },
    {
        "id": 167770288,
        "name": "Counting the Cost",
        "slug": "counting-the-cost",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1685444305l/167770288.jpg",
        "author": {
            "id": 6984799,
            "name": "Jill Duggar",
            "slug": "Jill_Duggar"
        },
        "publishedYear": 2023,
        "avgRating": 3.99,
        "totalRatings": 164179,
        "description": "For the first time, discover the unedited truth about the Duggars, the traditional Christian family that captivated the nation on TLC’s hit show 19 Kids and Counting. Jill Duggar and her husband Derick are finally ready to share their story, revealing the secrets, manipulation, and intimidation behind the show that remained hidden from their fans.\n\nJill and Derick knew a normal life wasn’t possible for them. As a star on the popular TLC reality show 19 Kids and Counting, Jill grew up in front of viewers who were fascinated by her family’s way of life. She was the responsible, second daughter of Jim Bob and Michelle’s nineteen kids; always with a baby on her hip and happy to wear the modest ankle-length dresses with throat-high necklines. She didn’t protest the strict model of patriarchy that her family followed, which declares that men are superior, that women are expected to be wives and mothers and are discouraged from attaining a higher education, and that parental authority over their children continues well into adulthood, even once they are married. \n\nBut as Jill got older, married Derick, and they embarked on their own lives, the red flags became too obvious to ignore. For as long as they could, Jill and Derick tried to be obedient family members — they weren’t willing to rock the boat. But now they’re raising a family of their own, and they’re done with the secrets. Thanks to time, tears, therapy, and blessings from God, they have the strength to share their journey. Theirs is a remarkable story of the power of the truth and is a moving example of how to find healing through honesty."
    },
    {
        "id": 101160634,
        "name": "Making It So",
        "slug": "making-it-so",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1683097620l/101160634.jpg",
        "author": {
            "id": 2256865,
            "name": "Patrick Stewart",
            "slug": "Patrick_Stewart"
        },
        "publishedYear": 2023,
        "avgRating": 4.3,
        "totalRatings": 21888
    },
    {
        "_note": "Response truncated for documentation purposes"
    }
]
最受欢迎的书籍类型 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14964/goodreads+books+api/39244/genre+most+read+books?slug=non-fiction' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回与搜索词匹配的Listopia书单,以及分页信息。返回的列表别名可以在/v1/list/books上使用
Endpoint ID: 39245
GET https://zylalabs.com/api/14964/goodreads+books+api/39245/search+lists
输入参数

搜索列表 — 端点功能

对象 描述
q 必需 Search term, at least 3 characters long.
page 可选 Page number, starting from 1 (defaults to 1).

剩余免费测试请求:3 / 3。


输入参数

q
page
API 示例响应
JSON
{
    "page": 1,
    "totalPages": 100,
    "totalResults": 9322,
    "lists": [
        {
            "id": 6,
            "name": "Best Books of the 20th Century",
            "slug": "Best_Books_of_the_20th_Century",
            "books": 7801,
            "voters": 49896,
            "images": [
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1612238791i/56916837.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1657781256i/61439040.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1598823299i/42844155.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1650033243i/41733839.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1325861570i/170448.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1546071216i/5907.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1367545443i/157993.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1383718290i/13079982.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1398034300i/5107.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1697079942i/132080146.jpg"
            ]
        },
        {
            "id": 5,
            "name": "Best Books of the Decade: 2000s",
            "slug": "Best_Books_of_the_Decade_2000s",
            "books": 7207,
            "voters": 28379,
            "images": [
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1627042661i/58613224.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1586722975i/2767052.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1627043894i/58613345.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1627044952i/58613424.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1794292347i/2.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1522157426i/19063.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1733519901i/18619684.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1541428344i/17165596.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1622355533i/4667024.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1655336738i/128029.jpg"
            ]
        },
        {
            "id": 50,
            "name": "The Best Epic Fantasy (fiction)",
            "slug": "The_Best_Epic_Fantasy_fiction_",
            "books": 4888,
            "voters": 27139,
            "images": [
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1562726234i/13496.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1656625315i/30.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1704917687i/186074.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1659905828i/7235533.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1659905815i/228665.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1661032875i/11127.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1617768316i/68428.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1442329494i/18116.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1673728072i/77197.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1366212852i/113436.jpg"
            ]
        },
        {
            "id": 47,
            "name": "Best Dystopian and Post-Apocalyptic Fiction",
            "slug": "Best_Dystopian_and_Post_Apocalyptic_Fiction",
            "books": 4146,
            "voters": 27053,
            "images": [
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1586722975i/2767052.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1657781256i/61439040.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1342493368i/3636.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1618526890i/13335037.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1575509280i/5129.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1383718290i/13079982.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1488552336i/34454589.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1325861570i/170448.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1327869409i/7624.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1785238097i/256023685.jpg"
            ]
        },
        {
            "id": 3,
            "name": "Best Science Fiction & Fantasy Books",
            "slug": "Best_Science_Fiction_Fantasy_Books",
            "books": 8917,
            "voters": 26344,
            "images": [
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1408303130i/375802.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1555447414i/44767458.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1657781256i/61439040.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1383718290i/13079982.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1575509280i/5129.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1417900846i/29579.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1586722975i/2767052.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1507963312i/33574273.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1404613595i/13.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1440319389i/4981.jpg"
            ]
        },
        {
            "id": 7,
            "name": "Best Books of the 21st Century",
            "slug": "Best_Books_of_the_21st_Century",
            "books": 9816,
            "voters": 22878,
            "images": [
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1627042661i/58613224.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1586722975i/2767052.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1579036753i/77203.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1522157426i/19063.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1627043894i/58613345.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1627045351i/58613451.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1622355533i/4667024.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1630609122i/58913358.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1655336738i/128029.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1631251689i/4214.jpg"
            ]
        },
        {
            "id": 1023,
            "name": "Best \"Strong Female\" Fantasy Novels",
            "slug": "Best_Strong_Female_Fantasy_Novels",
            "books": 4894,
            "voters": 19070,
            "images": [
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1331548394i/3236307.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1673566495i/76703559.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1388206270i/13831.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1388519019i/60510.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1361098973i/345627.jpg",
                "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1743122298i/71811.jpg"
            ]
        }
    ],
    "_note": "Response truncated for documentation purposes"
}
搜索列表 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14964/goodreads+books+api/39245/search+lists?q=fantasy&page=1' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回单个标签的书籍列表以及分页信息
Endpoint ID: 39246
GET https://zylalabs.com/api/14964/goodreads+books+api/39246/lists+by+tag
输入参数

按标签列出 — 端点功能

对象 描述
slug 必需 List tag slug. Use /v1/list/tags to list valid values.
page 可选 Page number, starting from 1 (defaults to 1).

剩余免费测试请求:3 / 3。


输入参数

slug
page
API 示例响应
JSON
{
    "page": 1,
    "totalPages": 100,
    "lists": [
        {
            "id": 1,
            "name": "Best Books Ever",
            "slug": "Best_Books_Ever",
            "books": 80191,
            "voters": 299067,
            "images": [
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1586722975l/2767052.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1320399351l/1885.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1553383690l/2657.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1794292347l/2.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1522157426l/19063.jpg"
            ]
        },
        {
            "id": 264,
            "name": "Books That Everyone Should Read At Least Once",
            "slug": "Books_That_Everyone_Should_Read_At_Least_Once",
            "books": 33261,
            "voters": 126299,
            "images": [
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1553383690l/2657.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1320399351l/1885.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1560816565l/48855.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1474154022l/3.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1657781256l/61439040.jpg"
            ]
        },
        {
            "id": 15,
            "name": "Best Historical Fiction",
            "slug": "Best_Historical_Fiction",
            "books": 8392,
            "voters": 27610,
            "images": [
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1409595968l/929.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1551144577l/18405.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1576956100l/5043.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1522157426l/19063.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1355932638l/37470.jpg"
            ]
        },
        {
            "id": 50,
            "name": "The Best Epic Fantasy (fiction)",
            "slug": "The_Best_Epic_Fantasy_fiction_",
            "books": 4888,
            "voters": 27139,
            "images": [
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1562726234l/13496.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1656625315l/30.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1704917687l/186074.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1659905828l/7235533.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1659905815l/228665.jpg"
            ]
        },
        {
            "id": 47,
            "name": "Best Dystopian and Post-Apocalyptic Fiction",
            "slug": "Best_Dystopian_and_Post_Apocalyptic_Fiction",
            "books": 4146,
            "voters": 27053,
            "images": [
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1586722975l/2767052.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1657781256l/61439040.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1342493368l/3636.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1618526890l/13335037.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1575509280l/5129.jpg"
            ]
        },
        {
            "id": 1023,
            "name": "Best \"Strong Female\" Fantasy Novels",
            "slug": "Best_Strong_Female_Fantasy_Novels",
            "books": 4894,
            "voters": 19070,
            "images": [
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1331548394l/3236307.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1673566495l/76703559.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1388206270l/13831.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1388519019l/60510.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1361098973l/345627.jpg"
            ]
        },
        {
            "id": 423,
            "name": "Books That Exceeded Your Expectations",
            "slug": "Books_That_Exceeded_Your_Expectations",
            "books": 16044,
            "voters": 18770,
            "images": [
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1586722975l/2767052.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1522157426l/19063.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1630609122l/58913358.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1579036753l/77203.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1170803558l/72193.jpg"
            ]
        },
        {
            "id": 17252,
            "name": "Can't Wait Books of 2014",
            "slug": "Can_t_Wait_Books_of_2014",
            "books": 2610,
            "voters": 15497,
            "images": [
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1460477794l/8755785.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1464201441l/18705209.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1699307836l/18635016.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1470057005l/13206828.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1461353810l/13618440.jpg"
            ]
        },
        {
            "id": 497,
            "name": "The Most Begun \"Read but Unfinished\" (Started) book ever",
            "slug": "The_Most_Begun_Read_but_Unfinished_Started_book_ever",
            "books": 2747,
            "voters": 13317,
            "images": [
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1463157317l/168668.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1566425108l/33.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1756682514l/338798.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1327940656l/153747.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1631816305l/1923820.jpg"
            ]
        },
        {
            "id": 397,
            "name": "Best Paranormal Romance Series",
            "slug": "Best_Paranormal_Romance_Series",
            "books": 1692,
            "voters": 12957,
            "images": [
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1429676285l/42899.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1700522826l/41865.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1373855613l/1421990.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1726371112l/112750.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1468560853l/301082.jpg"
            ]
        },
        {
            "id": 8460,
            "name": "Best Young Adult Realistic Novels",
            "slug": "Best_Young_Adult_Realistic_Novels",
            "books": 2803,
            "voters": 12544,
            "images": [
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1660273739l/11870085.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1650033115l/22628.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1652042180l/99561.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1358271931l/6936382.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1555345043l/29844228.jpg"
            ]
        },
        {
            "id": 319,
            "name": "Best Fantasy Series, Trilogies, and Duologies",
            "slug": "Best_Fantasy_Series_Trilogies_and_Duologies",
            "books": 2264,
            "voters": 12322,
            "images": [
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1474154022l/3.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1566425108l/33.jpg"
            ]
        }
    ],
    "_note": "Response truncated for documentation purposes"
}
按标签列出 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14964/goodreads+books+api/39246/lists+by+tag?slug=fiction&page=1' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回最受欢迎的Listopia书单以及分页信息
Endpoint ID: 39247
GET https://zylalabs.com/api/14964/goodreads+books+api/39247/most+popular+lists
输入参数

最受欢迎的列表 — 端点功能

对象 描述
page 可选 Page number, starting from 1 (defaults to 1).

剩余免费测试请求:3 / 3。


输入参数

page
API 示例响应
JSON
{
    "page": 1,
    "totalPages": 100,
    "lists": [
        {
            "id": 1,
            "name": "Best Books Ever",
            "slug": "Best_Books_Ever",
            "books": 80191,
            "voters": 299067,
            "images": [
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1586722975l/2767052.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1320399351l/1885.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1553383690l/2657.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1794292347l/2.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1522157426l/19063.jpg"
            ]
        },
        {
            "id": 264,
            "name": "Books That Everyone Should Read At Least Once",
            "slug": "Books_That_Everyone_Should_Read_At_Least_Once",
            "books": 33261,
            "voters": 126299,
            "images": [
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1553383690l/2657.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1320399351l/1885.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1560816565l/48855.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1474154022l/3.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1657781256l/61439040.jpg"
            ]
        },
        {
            "id": 43,
            "name": "Best Young Adult Books",
            "slug": "Best_Young_Adult_Books",
            "books": 13011,
            "voters": 80534,
            "images": [
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1598823299l/42844155.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1684776677l/123675190.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1586722975l/2767052.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1700522826l/41865.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1342493368l/3636.jpg"
            ]
        },
        {
            "id": 1043,
            "name": "Books That Should Be Made Into Movies",
            "slug": "Books_That_Should_Be_Made_Into_Movies",
            "books": 32886,
            "voters": 70470,
            "images": [
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1432730356l/1582996.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1358261334l/6339664.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1693490271l/7171637.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1369452339l/3777732.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1317067002l/30183.jpg"
            ]
        },
        {
            "id": 6,
            "name": "Best Books of the 20th Century",
            "slug": "Best_Books_of_the_20th_Century",
            "books": 7801,
            "voters": 49896,
            "images": [
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1612238791l/56916837.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1657781256l/61439040.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1598823299l/42844155.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1650033243l/41733839.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1325861570l/170448.jpg"
            ]
        },
        {
            "id": 10762,
            "name": "Best Book Boyfriends",
            "slug": "Best_Book_Boyfriends",
            "books": 11012,
            "voters": 29384,
            "images": [
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1358259032l/11505797.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1385207843l/10818853.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1666362713l/62967897.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1436142804l/25856606.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1618526890l/13335037.jpg"
            ]
        },
        {
            "id": 5,
            "name": "Best Books of the Decade: 2000s",
            "slug": "Best_Books_of_the_Decade_2000s",
            "books": 7207,
            "voters": 28379,
            "images": [
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1627042661l/58613224.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1586722975l/2767052.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1627043894l/58613345.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1627044952l/58613424.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1794292347l/2.jpg"
            ]
        },
        {
            "id": 15,
            "name": "Best Historical Fiction",
            "slug": "Best_Historical_Fiction",
            "books": 8392,
            "voters": 27610,
            "images": [
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1409595968l/929.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1551144577l/18405.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1576956100l/5043.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1522157426l/19063.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1355932638l/37470.jpg"
            ]
        },
        {
            "id": 50,
            "name": "The Best Epic Fantasy (fiction)",
            "slug": "The_Best_Epic_Fantasy_fiction_",
            "books": 4888,
            "voters": 27139,
            "images": [
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1562726234l/13496.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1656625315l/30.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1704917687l/186074.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1659905828l/7235533.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1659905815l/228665.jpg"
            ]
        },
        {
            "id": 47,
            "name": "Best Dystopian and Post-Apocalyptic Fiction",
            "slug": "Best_Dystopian_and_Post_Apocalyptic_Fiction",
            "books": 4146,
            "voters": 27053,
            "images": [
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1586722975l/2767052.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1657781256l/61439040.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1342493368l/3636.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1618526890l/13335037.jpg",
                "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1575509280l/5129.jpg"
            ]
        }
    ]
}
最受欢迎的列表 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14964/goodreads+books+api/39247/most+popular+lists?page=1' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回单一书单的书籍列表,按排名排列,连同它们的评分、投票和分页信息
Endpoint ID: 39248
GET https://zylalabs.com/api/14964/goodreads+books+api/39248/list+books
输入参数

列书 — 端点功能

对象 描述
slug 必需 List slug, the list id and name joined by a dot. Use /v1/search/lists or /v1/lists/tag to look one up.
page 可选 Page number, starting from 1 (defaults to 1).

剩余免费测试请求:3 / 3。


输入参数

slug
page
API 示例响应
JSON
{
    "page": 1,
    "totalPages": 100,
    "books": [
        {
            "rank": 1,
            "id": 2767052,
            "name": "The Hunger Games (The Hunger Games, #1)",
            "slug": "the-hunger-games",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1586722975i/2767052.jpg",
            "author": {
                "id": 153394,
                "name": "Suzanne Collins",
                "slug": "Suzanne_Collins"
            },
            "avgRating": 4.36,
            "totalRatings": 10365800,
            "score": 4585124,
            "votes": 46589
        },
        {
            "rank": 2,
            "id": 1885,
            "name": "Pride and Prejudice",
            "slug": "Pride_and_Prejudice",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1320399351i/1885.jpg",
            "author": {
                "id": 1265,
                "name": "Jane Austen",
                "slug": "Jane_Austen"
            },
            "avgRating": 4.3,
            "totalRatings": 5054093,
            "score": 3104160,
            "votes": 31792
        },
        {
            "rank": 3,
            "id": 2657,
            "name": "To Kill a Mockingbird",
            "slug": "To_Kill_a_Mockingbird",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1553383690i/2657.jpg",
            "author": {
                "id": 1825,
                "name": "Harper Lee",
                "slug": "Harper_Lee"
            },
            "avgRating": 4.26,
            "totalRatings": 7170987,
            "score": 2687694,
            "votes": 27440
        },
        {
            "rank": 4,
            "id": 2,
            "name": "Harry Potter and the Order of the Phoenix (Harry Potter, #5)",
            "slug": "Harry_Potter_and_the_Order_of_the_Phoenix",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1794292347i/2.jpg",
            "author": {
                "id": 1077326,
                "name": "J.K. Rowling",
                "slug": "J_K_Rowling"
            },
            "avgRating": 4.5,
            "totalRatings": 3963766,
            "score": 2399672,
            "votes": 26791
        },
        {
            "rank": 5,
            "id": 19063,
            "name": "The Book Thief",
            "slug": "The_Book_Thief",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1522157426i/19063.jpg",
            "author": {
                "id": 11466,
                "name": "Markus Zusak",
                "slug": "Markus_Zusak"
            },
            "avgRating": 4.39,
            "totalRatings": 3000174,
            "score": 2035830,
            "votes": 20903
        },
        {
            "rank": 6,
            "id": 41865,
            "name": "Twilight (The Twilight Saga, #1)",
            "slug": "Twilight",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1700522826i/41865.jpg",
            "author": {
                "id": 941441,
                "name": "Stephenie Meyer",
                "slug": "Stephenie_Meyer"
            },
            "avgRating": 3.68,
            "totalRatings": 7557256,
            "score": 1809586,
            "votes": 18448
        },
        {
            "rank": 7,
            "id": 170448,
            "name": "Animal Farm",
            "slug": "Animal_Farm",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1325861570i/170448.jpg",
            "author": {
                "id": 3706,
                "name": "George Orwell",
                "slug": "George_Orwell"
            },
            "avgRating": 4.03,
            "totalRatings": 4865701,
            "score": 1802427,
            "votes": 18644
        },
        {
            "rank": 8,
            "id": 30,
            "name": "J.R.R. Tolkien 4-Book Boxed Set: The Hobbit and The Lord of the Rings",
            "slug": "J_R_R_Tolkien_4_Book_Boxed_Set",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1656625315i/30.jpg",
            "author": {
                "id": 656983,
                "name": "J.R.R. Tolkien",
                "slug": "J_R_R_Tolkien"
            },
            "avgRating": 4.62,
            "totalRatings": 148115,
            "score": 1735181,
            "votes": 17960
        },
        {
            "rank": 9,
            "id": 11127,
            "name": "The Chronicles of Narnia (The Chronicles of Narnia, #1-7)",
            "slug": "The_Chronicles_of_Narnia",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1661032875i/11127.jpg",
            "author": {
                "id": 1069006,
                "name": "C.S. Lewis",
                "slug": "C_S_Lewis"
            },
            "avgRating": 4.28,
            "totalRatings": 727025,
            "score": 1572275,
            "votes": 16374
        },
        {
            "rank": 10,
            "id": 11870085,
            "name": "The Fault in Our Stars",
            "slug": "the-fault-in-our-stars",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1660273739i/11870085.jpg",
            "author": {
                "id": 1406384,
                "name": "John Green",
                "slug": "John_Green"
            },
            "avgRating": 4.12,
            "totalRatings": 5915725,
            "score": 1458350,
            "votes": 15088
        },
        {
            "rank": 11,
            "id": 5297,
            "name": "The Picture of Dorian Gray",
            "slug": "The_Picture_of_Dorian_Gray",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1546103428i/5297.jpg",
            "author": {
                "id": 3565,
                "name": "Oscar Wilde",
                "slug": "Oscar_Wilde"
            },
            "avgRating": 4.13,
            "totalRatings": 2035117,
            "score": 1434230,
            "votes": 14940
        },
        {
            "rank": 12,
            "id": 28187,
            "name": "The Lightning Thief (Percy Jackson and the Olympians, #1)",
            "slug": "The_Lightning_Thief",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1400602609i/28187.jpg",
            "author": {
                "id": 15872,
                "name": "Rick Riordan",
                "slug": "Rick_Riordan"
            },
            "avgRating": 4.31,
            "totalRatings": 3588374,
            "score": 1344438,
            "votes": 14020
        },
        {
            "rank": 13,
            "id": 6185,
            "name": "Wuthering Heights",
            "slug": "Wuthering_Heights",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1388212715i/6185.jpg",
            "author": {
                "id": 4191,
                "name": "Emily Brontë",
                "slug": "Emily_Bront_"
            },
            "avgRating": 3.89,
            "totalRatings": 2319886,
            "score": 1292265,
            "votes": 13474
        },
        {
            "rank": 14,
            "id": 370493,
            "name": "The Giving Tree",
            "slug": "The_Giving_Tree",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1769901237i/370493.jpg",
            "author": {
                "id": 435477,
                "name": "Shel Silverstein",
                "slug": "Shel_Silverstein"
            },
            "avgRating": 4.39,
            "totalRatings": 1269706,
            "score": 1274010,
            "votes": 13185
        },
        {
            "rank": 15,
            "id": 22628,
            "name": "The Perks of Being a Wallflower",
            "slug": "The_Perks_of_Being_a_Wallflower",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1650033115i/22628.jpg",
            "author": {
                "id": 12898,
                "name": "Stephen Chbosky",
                "slug": "Stephen_Chbosky"
            },
            "avgRating": 4.24,
            "totalRatings": 2088312,
            "score": 1242746,
            "votes": 12920
        },
        {
            "rank": 16,
            "id": 157993,
            "name": "The Little Prince",
            "slug": "The_Little_Prince",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1367545443i/157993.jpg",
            "author": {
                "id": 1020792,
                "name": "Antoine de Saint-Exupéry",
                "slug": "Antoine_de_Saint_Exup_ry"
            },
            "avgRating": 4.34,
            "totalRatings": 2637256,
            "score": 1236962,
            "votes": 13003
        },
        {
            "rank": 17,
            "id": 18405,
            "name": "Gone with the Wind",
            "slug": "Gone_with_the_Wind",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1551144577i/18405.jpg",
            "author": {
                "id": 11081,
                "name": "Margaret Mitchell",
                "slug": "Margaret_Mitchell"
            },
            "avgRating": 4.32,
            "totalRatings": 1275121
        }
    ],
    "_note": "Response truncated for documentation purposes"
}
列书 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14964/goodreads+books+api/39248/list+books?slug=1.Best_Books_Ever&page=1' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回流行书籍列表标签,每个标签的名称和别名,供列表搜索端点使用
Endpoint ID: 39249
GET https://zylalabs.com/api/14964/goodreads+books+api/39249/list+tags
输入参数

剩余免费测试请求:3 / 3。

此端点不需要任何输入参数。

API 示例响应
JSON
[
    {
        "name": "Romance",
        "slug": "romance"
    },
    {
        "name": "Fiction",
        "slug": "fiction"
    },
    {
        "name": "Young Adult",
        "slug": "young-adult"
    },
    {
        "name": "Fantasy",
        "slug": "fantasy"
    },
    {
        "name": "Science Fiction",
        "slug": "science-fiction"
    },
    {
        "name": "Non Fiction",
        "slug": "non-fiction"
    },
    {
        "name": "Children",
        "slug": "children"
    },
    {
        "name": "History",
        "slug": "history"
    },
    {
        "name": "Mystery",
        "slug": "mystery"
    },
    {
        "name": "Covers",
        "slug": "covers"
    },
    {
        "name": "Horror",
        "slug": "horror"
    },
    {
        "name": "Historical Fiction",
        "slug": "historical-fiction"
    },
    {
        "name": "Gay",
        "slug": "gay"
    },
    {
        "name": "Titles",
        "slug": "titles"
    },
    {
        "name": "Best",
        "slug": "best"
    },
    {
        "name": "Nonfiction",
        "slug": "nonfiction"
    },
    {
        "name": "Middle Grade",
        "slug": "middle-grade"
    },
    {
        "name": "Queer",
        "slug": "queer"
    },
    {
        "name": "Paranormal",
        "slug": "paranormal"
    },
    {
        "name": "Historical Romance",
        "slug": "historical-romance"
    },
    {
        "name": "Thriller",
        "slug": "thriller"
    },
    {
        "name": "Lgbt",
        "slug": "lgbt"
    },
    {
        "name": "Love",
        "slug": "love"
    },
    {
        "name": "Contemporary",
        "slug": "contemporary"
    },
    {
        "name": "Title Challenge",
        "slug": "title-challenge"
    },
    {
        "name": "Women",
        "slug": "women"
    },
    {
        "name": "Lgbtq",
        "slug": "lgbtq"
    },
    {
        "name": "Title",
        "slug": "title"
    },
    {
        "name": "Biography",
        "slug": "biography"
    },
    {
        "name": "Classics",
        "slug": "classics"
    }
]
列表标签 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14964/goodreads+books+api/39249/list+tags' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回与搜索词匹配的引用,连同其作者、书籍、点赞、标签和分页信息
Endpoint ID: 39250
GET https://zylalabs.com/api/14964/goodreads+books+api/39250/search+quotes
输入参数

搜索报价 — 端点功能

对象 描述
q 必需 Search term, at least 3 characters long.
page 可选 Page number, starting from 1 (defaults to 1).

剩余免费测试请求:3 / 3。


输入参数

q
page
API 示例响应
JSON
{
    "page": 1,
    "totalPages": 100,
    "quotes": [
        {
            "id": 2279,
            "slug": "being-deeply-loved-by-someone-gives-you-strength-while-loving",
            "text": "Being deeply loved by someone gives you strength, while loving someone deeply gives you courage.",
            "image": null,
            "author": {
                "id": 2622245,
                "name": "Lao Tzu",
                "slug": "Lao_Tzu",
                "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/authors/1435903703i/2622245.jpg"
            },
            "book": null,
            "likes": 34947,
            "tags": [
                {
                    "name": "Courage",
                    "slug": "courage"
                },
                {
                    "name": "Deeply Loved",
                    "slug": "deeply-loved"
                },
                {
                    "name": "Love",
                    "slug": "love"
                },
                {
                    "name": "Strength",
                    "slug": "strength"
                },
                {
                    "name": "Widely Misattributed",
                    "slug": "widely-misattributed"
                }
            ]
        },
        {
            "id": 8667,
            "slug": "it-takes-a-great-deal-of-bravery-to-stand-up",
            "text": "It takes a great deal of bravery to stand up to our enemies, but just as much to stand up to our friends.",
            "image": null,
            "author": {
                "id": 1077326,
                "name": "J.K. Rowling",
                "slug": "J_K_Rowling",
                "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/authors/1596216614i/1077326.jpg"
            },
            "book": {
                "name": "Harry Potter and the Sorcerer's Stone"
            },
            "likes": 32095,
            "tags": [
                {
                    "name": "Albus Dumbledore",
                    "slug": "albus-dumbledore"
                },
                {
                    "name": "Courage",
                    "slug": "courage"
                },
                {
                    "name": "Friends",
                    "slug": "friends"
                }
            ]
        },
        {
            "id": 3270,
            "slug": "success-is-not-final-failure-is-not-fatal-it-is",
            "text": "Success is not final, failure is not fatal: it is the courage to continue that counts.",
            "image": null,
            "author": {
                "id": 14033,
                "name": "Winston S. Churchill",
                "slug": "Winston_S_Churchill",
                "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/authors/1306133803i/14033.jpg"
            },
            "book": null,
            "likes": 23600,
            "tags": [
                {
                    "name": "Bravery",
                    "slug": "bravery"
                },
                {
                    "name": "Courage",
                    "slug": "courage"
                },
                {
                    "name": "Failure",
                    "slug": "failure"
                },
                {
                    "name": "Inspirational",
                    "slug": "inspirational"
                },
                {
                    "name": "Success",
                    "slug": "success"
                }
            ]
        },
        {
            "id": 806,
            "slug": "it-takes-courage-to-grow-up-and-become-who-you",
            "text": "It takes courage to grow up and become who you really are.",
            "image": "https://images.gr-assets.com/quotes/1394570348p2/806.jpg",
            "author": {
                "id": null,
                "name": "E.E. Cummings",
                "slug": null,
                "image": null
            },
            "book": null,
            "likes": 17047,
            "tags": [
                {
                    "name": "Attributed No Source",
                    "slug": "attributed-no-source"
                },
                {
                    "name": "Courage",
                    "slug": "courage"
                }
            ]
        },
        {
            "id": 378643,
            "slug": "we-believe-in-ordinary-acts-of-bravery-in-the-courage",
            "text": "We believe in ordinary acts of bravery, in the courage that drives one person to stand up for another.",
            "image": null,
            "author": {
                "id": 4039811,
                "name": "Veronica Roth",
                "slug": "Veronica_Roth",
                "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/authors/1775697148i/4039811.jpg"
            },
            "book": {
                "name": "Divergent"
            },
            "likes": 16604,
            "tags": [
                {
                    "name": "Inspirational Quotes",
                    "slug": "inspirational-quotes"
                },
                {
                    "name": "Strength And Courage",
                    "slug": "strength-and-courage"
                }
            ]
        },
        {
            "id": 745,
            "slug": "perhaps-all-the-dragons-in-our-lives-are-princesses-who",
            "text": "Perhaps all the dragons in our lives are princesses who are only waiting to see us act, just once, with beauty and courage. Perhaps everything that frightens us is, in its deepest essence, something helpless that wants our love.",
            "image": null,
            "author": {
                "id": 7906,
                "name": "Rainer Maria Rilke",
                "slug": "Rainer_Maria_Rilke",
                "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/authors/1651322555i/7906.jpg"
            },
            "book": {
                "name": "Letters to a Young Poet"
            },
            "likes": 12045,
            "tags": [
                {
                    "name": "Love",
                    "slug": "love"
                }
            ]
        },
        {
            "id": 1589,
            "slug": "you-will-always-be-fond-of-me-i-represent-to",
            "text": "You will always be fond of me. I represent to you all the sins you never had the courage to commit.",
            "image": null,
            "author": {
                "id": 3565,
                "name": "Oscar Wilde",
                "slug": "Oscar_Wilde",
                "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/authors/1673611182i/3565.jpg"
            },
            "book": {
                "name": "The Picture of Dorian Gray"
            },
            "likes": 11056,
            "tags": [
                {
                    "name": "Sin",
                    "slug": "sin"
                }
            ]
        },
        {
            "id": 350,
            "slug": "i-with-a-deeper-instinct-choose-a-man-who-compels",
            "text": "I, with a deeper instinct, choose a man who compels my strength, who makes enormous demands on me, who does not doubt my courage or my toughness, who does not believe me naïve or innocent, who has the courage to treat me like a woman.",
            "image": null,
            "author": {
                "id": 7190,
                "name": "Anaïs Nin",
                "slug": "Ana_s_Nin",
                "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/authors/1585811222i/7190.jpg"
            },
            "book": null,
            "likes": 9425,
            "tags": [
                {
                    "name": "Men",
                    "slug": "men"
                },
                {
                    "name": "Women",
                    "slug": "women"
                }
            ]
        },
        {
            "id": 255103,
            "slug": "i-wanted-so-badly-to-lie-down-next-to-her",
            "text": "I wanted so badly to lie down next to her on the couch, to wrap my arms around her and sleep. Not fuck, like in those movies. Not even have sex. Just sleep together in the most innocent sense of the phrase. But I lacked the courage and she had a boyfriend and I was gawky and she was gorgeous and I was hopelessly boring and she was endlessly fascinating. So I walked back to my room and collapsed on the bottom bunk, thinking that if people were rain, I was drizzle and she was hurricane.",
            "image": null,
            "author": {
                "id": 1406384,
                "name": "John Green",
                "slug": "John_Green",
                "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/authors/1777281990i/1406384.jpg"
            },
            "book": {
                "name": "Looking for Alaska"
            },
            "likes": 8523,
            "tags": [
                {
                    "name": "Unrequited Love",
                    "slug": "unrequited-love"
                }
            ]
        },
        {
            "id": 6019,
            "slug": "i-wanted-you-to-see-what-real-courage-is-instead"
        }
    ],
    "_note": "Response truncated for documentation purposes"
}
搜索报价 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14964/goodreads+books+api/39250/search+quotes?q=courage&page=1' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回单个标签的报价及分页信息
Endpoint ID: 39251
GET https://zylalabs.com/api/14964/goodreads+books+api/39251/quotes+by+tag
输入参数

按标签的引用 — 端点功能

对象 描述
slug 必需 Quote tag slug. Use /v1/quote/tags to list valid values.
page 可选 Page number, starting from 1 (defaults to 1).

剩余免费测试请求:3 / 3。


输入参数

slug
page
API 示例响应
JSON
{
    "page": 1,
    "totalPages": 100,
    "quotes": [
        {
            "id": 66,
            "slug": "so-many-books-so-little-time",
            "text": "So many books, so little time.",
            "image": null,
            "author": {
                "id": 22302,
                "name": "Frank Zappa",
                "slug": "Frank_Zappa",
                "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/authors/1696236573i/22302.jpg"
            },
            "book": null,
            "likes": 153212,
            "tags": [
                {
                    "name": "Books",
                    "slug": "books"
                },
                {
                    "name": "Humor",
                    "slug": "humor"
                }
            ]
        },
        {
            "id": 942,
            "slug": "two-things-are-infinite-the-universe-and-human-stupidity-and",
            "text": "Two things are infinite: the universe and human stupidity; and I'm not sure about the universe.",
            "image": null,
            "author": {
                "id": 9810,
                "name": "Albert Einstein",
                "slug": "Albert_Einstein",
                "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/authors/1429114964i/9810.jpg"
            },
            "book": null,
            "likes": 149335,
            "tags": [
                {
                    "name": "Attributed No Source",
                    "slug": "attributed-no-source"
                },
                {
                    "name": "Human Nature",
                    "slug": "human-nature"
                },
                {
                    "name": "Humor",
                    "slug": "humor"
                },
                {
                    "name": "Infinity",
                    "slug": "infinity"
                },
                {
                    "name": "Philosophy",
                    "slug": "philosophy"
                },
                {
                    "name": "Science",
                    "slug": "science"
                },
                {
                    "name": "Stupidity",
                    "slug": "stupidity"
                },
                {
                    "name": "Universe",
                    "slug": "universe"
                }
            ]
        },
        {
            "id": 1598,
            "slug": "you-only-live-once-but-if-you-do-it-right",
            "text": "You only live once, but if you do it right, once is enough.",
            "image": null,
            "author": {
                "id": 259666,
                "name": "Mae West",
                "slug": "Mae_West",
                "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/authors/1738043431i/259666.jpg"
            },
            "book": null,
            "likes": 119878,
            "tags": [
                {
                    "name": "Humor",
                    "slug": "humor"
                },
                {
                    "name": "Life",
                    "slug": "life"
                }
            ]
        },
        {
            "id": 5543,
            "slug": "insanity-is-doing-the-same-thing-over-and-over-again",
            "text": "Insanity is doing the same thing, over and over again, but expecting different results.",
            "image": null,
            "author": {
                "id": null,
                "name": "Narcotics Anonymous",
                "slug": null,
                "image": null
            },
            "book": null,
            "likes": 64866,
            "tags": [
                {
                    "name": "Humor",
                    "slug": "humor"
                },
                {
                    "name": "Insanity",
                    "slug": "insanity"
                },
                {
                    "name": "Life",
                    "slug": "life"
                },
                {
                    "name": "Misattributed Ben Franklin",
                    "slug": "misattributed-ben-franklin"
                },
                {
                    "name": "Misattributed Mark Twain",
                    "slug": "misattributed-mark-twain"
                },
                {
                    "name": "Misattributed To Einstein",
                    "slug": "misattributed-to-einstein"
                }
            ]
        },
        {
            "id": 5797,
            "slug": "the-person-be-it-gentleman-or-lady-who-has-not",
            "text": "The person, be it gentleman or lady, who has not pleasure in a good novel, must be intolerably stupid.",
            "image": null,
            "author": {
                "id": 1265,
                "name": "Jane Austen",
                "slug": "Jane_Austen",
                "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/authors/1651510251i/1265.jpg"
            },
            "book": {
                "name": "Northanger Abbey"
            },
            "likes": 51821,
            "tags": [
                {
                    "name": "Aliteracy",
                    "slug": "aliteracy"
                },
                {
                    "name": "Books",
                    "slug": "books"
                },
                {
                    "name": "Classic",
                    "slug": "classic"
                },
                {
                    "name": "Humor",
                    "slug": "humor"
                }
            ]
        },
        {
            "id": 352,
            "slug": "outside-of-a-dog-a-book-is-man-s-best-friend",
            "text": "Outside of a dog, a book is man's best friend. Inside of a dog it's too dark to read.",
            "image": null,
            "author": {
                "id": 43244,
                "name": "Groucho Marx",
                "slug": "Groucho_Marx",
                "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/authors/1198590177i/43244.jpg"
            },
            "book": {
                "name": "The Essential Groucho: Writings For By And About Groucho Marx"
            },
            "likes": 38082,
            "tags": [
                {
                    "name": "Animals",
                    "slug": "animals"
                },
                {
                    "name": "Books",
                    "slug": "books"
                },
                {
                    "name": "Dogs",
                    "slug": "dogs"
                },
                {
                    "name": "Friends",
                    "slug": "friends"
                },
                {
                    "name": "Humor",
                    "slug": "humor"
                }
            ]
        },
        {
            "id": 298,
            "slug": "a-day-without-sunshine-is-like-you-know-night",
            "text": "A day without sunshine is like, you know, night.",
            "image": null,
            "author": {
                "id": 7103,
                "name": "Steve Martin",
                "slug": "Steve_Martin",
                "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/authors/1585425013i/7103.jpg"
            },
            "book": null,
            "likes": 35269,
            "tags": [
                {
                    "name": "Humor",
                    "slug": "humor"
                },
                {
                    "name": "Obvious",
                    "slug": "obvious"
                },
                {
                    "name": "Simile",
                    "slug": "simile"
                }
            ]
        },
        {
            "id": 1398,
            "slug": "i-love-deadlines-i-love-the-whooshing-noise-they-make",
            "text": "I love deadlines. I love the whooshing noise they make as they go by.",
            "image": null,
            "author": {
                "id": 4,
                "name": "Douglas Adams",
                "slug": "Douglas_Adams",
                "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/authors/1616277702i/4.jpg"
            },
            "book": {
                "name": "The Salmon of Doubt: Hitchhiking the Galaxy One Last Time"
            },
            "likes": 32203,
            "tags": [
                {
                    "name": "Deadlines",
                    "slug": "deadlines"
                },
                {
                    "name": "Humor",
                    "slug": "humor"
                },
                {
                    "name": "Humour",
                    "slug": "humour"
                },
                {
                    "name": "Work",
                    "slug": "work"
                },
                {
                    "name": "Writing",
                    "slug": "writing"
                }
            ]
        },
        {
            "id": 5979,
            "slug": "anyone-who-thinks-sitting-in-church-can-make-you-a",
            "text": "Anyone who thinks sitting in church can make you a Christian must also think that sitting in a garage can make you a car.",
            "image": null,
            "author": {
                "id": 2014,
                "name": "Garrison Keillor",
                "slug": "Garrison_Keillor"
            }
        }
    ],
    "_note": "Response truncated for documentation purposes"
}
按标签的引用 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14964/goodreads+books+api/39251/quotes+by+tag?slug=humor&page=1' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回流行标签及每个标签中的引用数量
Endpoint ID: 39252
GET https://zylalabs.com/api/14964/goodreads+books+api/39252/quote+tags
输入参数

剩余免费测试请求:3 / 3。

此端点不需要任何输入参数。

API 示例响应
JSON
[
    {
        "name": "Love",
        "slug": "love",
        "quotes": 102500
    },
    {
        "name": "Life",
        "slug": "life",
        "quotes": 81000
    },
    {
        "name": "Inspirational",
        "slug": "inspirational",
        "quotes": 78000
    },
    {
        "name": "Humor",
        "slug": "humor",
        "quotes": 45500
    },
    {
        "name": "Philosophy",
        "slug": "philosophy",
        "quotes": 32000
    },
    {
        "name": "Inspirational Quotes",
        "slug": "inspirational-quotes",
        "quotes": 29000
    },
    {
        "name": "God",
        "slug": "god",
        "quotes": 27000
    },
    {
        "name": "Wisdom",
        "slug": "wisdom",
        "quotes": 25500
    },
    {
        "name": "Romance",
        "slug": "romance",
        "quotes": 25000
    },
    {
        "name": "Truth",
        "slug": "truth",
        "quotes": 25000
    },
    {
        "name": "Poetry",
        "slug": "poetry",
        "quotes": 25000
    },
    {
        "name": "Life Lessons",
        "slug": "life-lessons",
        "quotes": 23000
    },
    {
        "name": "Quotes",
        "slug": "quotes",
        "quotes": 21500
    },
    {
        "name": "Death",
        "slug": "death",
        "quotes": 21000
    },
    {
        "name": "Happiness",
        "slug": "happiness",
        "quotes": 19000
    },
    {
        "name": "Hope",
        "slug": "hope",
        "quotes": 19000
    },
    {
        "name": "Faith",
        "slug": "faith",
        "quotes": 19000
    },
    {
        "name": "Inspiration",
        "slug": "inspiration",
        "quotes": 18500
    },
    {
        "name": "Relationships",
        "slug": "relationships",
        "quotes": 16500
    },
    {
        "name": "Spirituality",
        "slug": "spirituality",
        "quotes": 16000
    },
    {
        "name": "Motivational",
        "slug": "motivational",
        "quotes": 16000
    },
    {
        "name": "Religion",
        "slug": "religion",
        "quotes": 15500
    },
    {
        "name": "Life Quotes",
        "slug": "life-quotes",
        "quotes": 15500
    },
    {
        "name": "Writing",
        "slug": "writing",
        "quotes": 15000
    },
    {
        "name": "Love Quotes",
        "slug": "love-quotes",
        "quotes": 15000
    },
    {
        "name": "Success",
        "slug": "success",
        "quotes": 14500
    },
    {
        "name": "Motivation",
        "slug": "motivation",
        "quotes": 14000
    },
    {
        "name": "Time",
        "slug": "time",
        "quotes": 13000
    },
    {
        "name": "Science",
        "slug": "science",
        "quotes": 12500
    },
    {
        "name": "Motivational Quotes",
        "slug": "motivational-quotes",
        "quotes": 12000
    }
]
引号标签 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14964/goodreads+books+api/39252/quote+tags' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回单一年份的Goodreads选择奖类别
Endpoint ID: 39253
GET https://zylalabs.com/api/14964/goodreads+books+api/39253/choice+award+categories
输入参数

选择奖类别 — 端点功能

对象 描述
year 必需 Award year, from 2011 up to the current year.

剩余免费测试请求:3 / 3。


输入参数

year
API 示例响应
JSON
[
    {
        "name": "Fiction",
        "slug": "readers-favorite-fiction-books-2025"
    },
    {
        "name": "Historical Fiction",
        "slug": "readers-favorite-historical-fiction-books-2025"
    },
    {
        "name": "Mystery & Thriller",
        "slug": "readers-favorite-mystery-thriller-books-2025"
    },
    {
        "name": "Romance",
        "slug": "readers-favorite-romance-books-2025"
    },
    {
        "name": "Romantasy",
        "slug": "readers-favorite-romantasy-books-2025"
    },
    {
        "name": "Fantasy",
        "slug": "readers-favorite-fantasy-books-2025"
    },
    {
        "name": "Science Fiction",
        "slug": "readers-favorite-science-fiction-books-2025"
    },
    {
        "name": "Horror",
        "slug": "readers-favorite-horror-books-2025"
    },
    {
        "name": "Debut Novel",
        "slug": "readers-favorite-debut-novel-2025"
    },
    {
        "name": "Audiobook",
        "slug": "readers-favorite-audio-books-2025"
    },
    {
        "name": "Young Adult Fantasy & Sci-Fi",
        "slug": "readers-favorite-ya-fantasy-and-science-fiction-books-2025"
    },
    {
        "name": "Young Adult Fiction",
        "slug": "readers-favorite-ya-fiction-books-2025"
    },
    {
        "name": "Nonfiction",
        "slug": "readers-favorite-nonfiction-books-2025"
    },
    {
        "name": "Memoir",
        "slug": "readers-favorite-memoir-books-2025"
    },
    {
        "name": "History & Biography",
        "slug": "readers-favorite-history-bio-books-2025"
    }
]
选择奖类别 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14964/goodreads+books+api/39253/choice+award+categories?year=2025' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回单个 Goodreads 选择奖类别的提名书籍,连同它们的投票和获胜标志
Endpoint ID: 39254
GET https://zylalabs.com/api/14964/goodreads+books+api/39254/choice+award+books
输入参数

获奖图书 — 端点功能

对象 描述
slug 必需 Choice award category slug. Use /v1/choice-awards/categories to list valid values.

剩余免费测试请求:3 / 3。


输入参数

slug
API 示例响应
JSON
[
    {
        "id": 217163697,
        "name": "My Friends",
        "slug": "my-friends",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1734625930l/217163697.jpg",
        "author": {
            "id": 6485178,
            "name": "Fredrik Backman",
            "slug": "Fredrik_Backman"
        },
        "publishedYear": 2025,
        "avgRating": 4.29,
        "totalRatings": 653815,
        "description": "The beautiful new novel that will make you laugh and cry, from the global bestselling author of Anxious People and A Man Called Ove. Fredrik Backman returns with an unforgettably funny, deeply moving tale of four teenagers whose friendship creates a bond so powerful that it changes a complete stranger’s life twenty-five years later…\n\nYou have to take life for granted, the artist thinks, the whole thing: sunrises and slow Sunday mornings and water balloons and another person’s breath against your neck. That’s the only courageous thing a person can do.\n \nIn the corner of one of the most famous paintings in the world three tiny figures sit at the end of a pier. Most people don’t even notice them. Most people think it’s just a depiction of the sea. But Louisa, an aspiring artist herself, knows otherwise.\n\nTwenty-five years earlier, in a distant seaside town, a group of teenagers seek refuge from their bruising home lives by spending long summer days together. They tell jokes, they share secrets, and they commit small acts of rebellion. These lost souls find in each other a reason to get up each morning, a reason to dream, a reason to love.\n\nOut of that summer emerges a transcendent work of art, a painting that will unexpectedly be placed into 18-year-old Louisa’s care. Determined to learn how it came to be and to decide what to do with it, Louisa embarks on a cross-country journey. But the closer she gets to the painting’s birthplace, the more nervous she becomes.\n \nIn this stunning testament to the transformative, timeless power of friendship and art, Louisa is proof that happy endings don’t always take the form we expect.",
        "votes": 167509,
        "winner": true
    },
    {
        "id": 211004089,
        "name": "Wild Dark Shore",
        "slug": "wild-dark-shore",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1715784093l/211004089.jpg",
        "author": {
            "id": 2869149,
            "name": "Charlotte McConaghy",
            "slug": "Charlotte_McConaghy"
        },
        "publishedYear": 2025,
        "avgRating": 4.04,
        "totalRatings": 676096,
        "description": "Dominic Salt and his three children are caretakers of Shearwater, a tiny island not far from Antarctica. Home to the world’s largest seed bank, Shearwater was once full of researchers, but with sea levels rising, the Salts are now its final inhabitants. Until, during the worst storm the island has ever seen, a woman mysteriously washes ashore.\n\nIsolation has taken its toll on the Salts, but as they nurse the woman, Rowan, back to strength, it begins to feel like she might just be what they need. Rowan, long accustomed to protecting herself, starts imagining a future where she could belong to someone again.\n\nBut Rowan isn’t telling the whole truth about why she set out for Shearwater. And when she discovers sabotaged radios and a freshly dug grave, she realizes Dominic is keeping his own secrets. As the storms on Shearwater gather force, they all must decide if they can trust each other enough to protect the precious seeds in their care before it’s too late―and if they can finally put the tragedies of the past behind them to create something new, together.\n\nA novel of breathtaking twists, dizzying beauty, and ferocious love, Wild Dark Shore is about the impossible choices we make to protect the people we love, even as the world around us disappears.",
        "votes": 107486,
        "winner": false
    },
    {
        "id": 223001257,
        "name": "The Correspondent",
        "slug": "the-correspondent",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1735235942l/223001257.jpg",
        "author": {
            "id": 51997621,
            "name": "Virginia      Evans",
            "slug": "Virginia_Evans"
        },
        "publishedYear": 2025,
        "avgRating": 4.41,
        "totalRatings": 1015365,
        "description": "“Imagine, the letters one has sent out into the world, the letters received back in turn, are like the pieces of a magnificent puzzle. . . . Isn’t there something wonderful in that, to think that a story of one’s life is preserved in some way, that this very letter may one day mean something, even if it is a very small thing, to someone?”\n\nFilled with knowledge that only comes from a life fully lived, The Correspondent is a gem of a novel about the power of finding solace in literature and connection with people we might never meet in person. It is about the hubris of youth and the wisdom of old age, and the mistakes and acts of kindness that occur during a lifetime.\n\nSybil Van Antwerp has throughout her life used letters to make sense of the world and her place in it. Most mornings, around half past ten, Sybil sits down to write letters—to her brother, to her best friend, to the president of the university who will not allow her to audit a class she desperately wants to take, to Joan Didion and Larry McMurtry to tell them what she thinks of their latest books, and to one person to whom she writes often yet never sends the letter.\n\nSybil expects her world to go on as it always has—a mother, grandmother, wife, divorcee, distinguished lawyer, she has lived a very full life. But when letters from someone in her past force her to examine one of the most painful periods of her life, she realizes that the letter she has been writing over the years needs to be read and that she cannot move forward until she finds it in her heart to offer forgiveness.\n\nSybil Van Antwerp’s life of letters might be “a very small thing,” but she also might be one of the most memorable characters you will ever read.",
        "votes": 41827,
        "winner": false
    },
    {
        "id": 217245618,
        "name": "The Names",
        "slug": "the-names",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1746106001l/217245618.jpg",
        "author": {
            "id": 17201569,
            "name": "Florence Knapp",
            "slug": "Florence_Knapp"
        },
        "publishedYear": 2025,
        "avgRating": 4.11,
        "totalRatings": 375845,
        "description": "In the wake of a catastrophic storm, Cora sets off with her nine-year-old daughter, Maia, to register her son's birth. Her husband, Gordon, respected in the community but a controlling presence at home, intends for her to follow a long-standing family tradition and name the baby after him. But when faced with the decision, Cora hesitates...\n\nSpanning thirty-five years, what follows are three alternate and alternating versions of their lives, shaped by Cora’s last-minute choice of name. In richly layered prose, The Names explores the painful ripple effects of domestic abuse, the messy ties of family, and the possibilities of autonomy and healing.\n\nThrough a prism of what-ifs, Florence Knapp invites us to consider the \"one . . . precious life\" we are given. Full of hope, this is the story of three names, three versions of a life, and the infinite possibilities that a single decision can spark. It is the story of one family and love’s endless capacity to endure, no matter what fate has in store.\n\nThe book’s brilliantly imaginative structure, propulsive storytelling, and emotional power are certain to make The Names a modern classic.",
        "votes": 41454,
        "winner": false
    },
    {
        "id": 223541023,
        "name": "The Academy",
        "slug": "the-academy",
        "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1738247902l/223541023.jpg",
        "author": {
            "id": 88301,
            "name": "Elin Hilderbrand",
            "slug": "Elin_Hilderbrand"
        },
        "publishedYear": 2025,
        "avgRating": 3.66,
        "totalRatings": 167266
    },
    {
        "_note": "Response truncated for documentation purposes"
    }
]
获奖图书 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14964/goodreads+books+api/39254/choice+award+books?slug=readers-favorite-fiction-books-2025' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回匹配搜索词的读者组,以及它们的成员数量、最近活动、位置和分页信息
Endpoint ID: 39255
GET https://zylalabs.com/api/14964/goodreads+books+api/39255/search+groups
输入参数

搜索组 — 端点功能

对象 描述
q 必需 Search term, at least 3 characters long.
page 可选 Page number, starting from 1 (defaults to 1).

剩余免费测试请求:3 / 3。


输入参数

q
page
API 示例响应
JSON
{
    "page": 1,
    "totalPages": 100,
    "totalResults": 2257,
    "groups": [
        {
            "id": 185,
            "name": "What's the Name of That Book???",
            "slug": "what-s-the-name-of-that-book",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/groups/1713666340i/185.jpg",
            "members": 122000,
            "lastActivity": "4h",
            "location": "US"
        },
        {
            "id": 64233,
            "name": "Addicted to YA",
            "slug": "addicted-to-ya",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/groups/1329254899i/64233.jpg",
            "members": 66300,
            "lastActivity": "4h",
            "location": "US"
        },
        {
            "id": 26989,
            "name": "Goodreads Authors/Readers",
            "slug": "goodreads-authors-readers",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/groups/1258849870i/26989.jpg",
            "members": 58100,
            "lastActivity": "11m",
            "location": "US"
        },
        {
            "id": 1178137,
            "name": "romance addicts .•° ✿ °•.",
            "slug": "romance-addicts",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/groups/1640903532i/1178137.jpg",
            "members": 44800,
            "lastActivity": "2d",
            "location": "US"
        },
        {
            "id": 1865,
            "name": "SciFi and Fantasy Book Club",
            "slug": "scifi-and-fantasy-book-club",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/groups/1617365072i/1865.jpg",
            "members": 43700,
            "lastActivity": "2h",
            "location": "Seattle, WA, US"
        },
        {
            "id": 20149,
            "name": "M/M Romance",
            "slug": "m-m-romance",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/groups/1267455823i/20149.jpg",
            "members": 38300,
            "lastActivity": "46m",
            "location": "US"
        },
        {
            "id": 88432,
            "name": "The Perks Of Being A Book Addict",
            "slug": "the-perks-of-being-a-book-addict",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/groups/1357414710i/88432.jpg",
            "members": 37800,
            "lastActivity": "6h",
            "location": "US"
        },
        {
            "id": 189072,
            "name": "EVERYONE Has Read This but Me - The Catch-Up Book Club",
            "slug": "everyone-has-read-this-but-me-the-catch-up-book-club",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/groups/1506205315i/189072.jpg",
            "members": 29300,
            "lastActivity": "3h",
            "location": "US"
        },
        {
            "id": 1193063,
            "name": "Booktok & Bookstagram ✿",
            "slug": "booktok-bookstagram",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/groups/1739295561i/1193063.jpg",
            "members": 29200,
            "lastActivity": "5h",
            "location": "US"
        },
        {
            "id": 35559,
            "name": "Nothing But Reading Challenges",
            "slug": "nothing-but-reading-challenges",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/groups/1462035099i/35559.jpg",
            "members": 27700,
            "lastActivity": "15m",
            "location": "US"
        },
        {
            "id": 142309,
            "name": "Underground Knowledge — A discussion group",
            "slug": "underground-knowledge-a-discussion-group",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/groups/1785893575i/142309.jpg",
            "members": 26400,
            "lastActivity": "14h",
            "location": "US"
        },
        {
            "id": 390,
            "name": "Paranormal Romance & Urban Fantasy",
            "slug": "paranormal-romance-urban-fantasy",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/groups/1382734934i/390.jpg",
            "members": 24600,
            "lastActivity": "2d",
            "location": "US"
        },
        {
            "id": 1193460,
            "name": "A Court of Fantasy and Fiction",
            "slug": "a-court-of-fantasy-and-fiction",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/groups/1721740035i/1193460.jpg",
            "members": 23300,
            "lastActivity": "1d",
            "location": "US"
        },
        {
            "id": 4170,
            "name": "The Sword and Laser",
            "slug": "the-sword-and-laser",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/groups/1208199283i/4170.jpg",
            "members": 21600,
            "lastActivity": "5h",
            "location": "US"
        },
        {
            "id": 1163715,
            "name": "BookTok Besties",
            "slug": "booktok-besties",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/groups/1621410455i/1163715.jpg",
            "members": 21000,
            "lastActivity": "1d",
            "location": "US"
        },
        {
            "id": 203,
            "name": "Stephen King Fans",
            "slug": "stephen-king-fans",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/groups/1217304059i/203.jpg",
            "members": 20600,
            "lastActivity": "10h",
            "location": "US"
        },
        {
            "id": 1193144,
            "name": "hopeless romantic society",
            "slug": "hopeless-romantic-society",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/groups/1660021413i/1193144.jpg",
            "members": 18800,
            "lastActivity": "4h",
            "location": "US"
        },
        {
            "id": 73843,
            "name": "YA Buddy Readers' Corner ♥",
            "slug": "ya-buddy-readers-corner",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/groups/1420647858i/73843.jpg",
            "members": 18100,
            "lastActivity": "8h",
            "location": "GB"
        },
        {
            "id": 354,
            "name": "Harry Potter",
            "slug": "harry-potter",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/groups/1183921559i/354.jpg",
            "members": 17500,
            "lastActivity": "2d",
            "location": "US"
        },
        {
            "id": 62938,
            "name": "Vaginal Fantasy Book Club",
            "slug": "vaginal-fantasy-book-club",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/groups/1401146798i/62938.jpg",
            "members": 16100,
            "lastActivity": "4d",
            "location": "Santa Monica, CA, US"
        }
    ]
}
搜索组 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14964/goodreads+books+api/39255/search+groups?q=fantasy&page=1' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回匹配搜索词的成员,以及他们的书籍和好友数量、位置、当前阅读的书籍和分页信息
Endpoint ID: 39256
GET https://zylalabs.com/api/14964/goodreads+books+api/39256/search+people
输入参数

搜索人物 — 端点功能

对象 描述
q 必需 Search term, at least 3 characters long.
page 可选 Page number, starting from 1 (defaults to 1).

剩余免费测试请求:3 / 3。


输入参数

q
page
API 示例响应
JSON
{
    "page": 1,
    "totalPages": 10,
    "totalResults": 200,
    "people": [
        {
            "id": 660486,
            "name": "Stephen Vachon",
            "slug": "stephen-vachon",
            "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/users/1200545266i/660486.jpg",
            "books": 569,
            "friends": 6,
            "location": null,
            "currentlyReading": null
        },
        {
            "id": 623865,
            "name": "Stephen",
            "slug": "stephen",
            "image": null,
            "books": 0,
            "friends": 0,
            "location": null,
            "currentlyReading": null
        },
        {
            "id": 72,
            "name": "Stephen",
            "slug": "stephen",
            "image": null,
            "books": 10,
            "friends": 1,
            "location": null,
            "currentlyReading": null
        },
        {
            "id": 154441,
            "name": "Stephen",
            "slug": "stephen",
            "image": null,
            "books": 1,
            "friends": 4,
            "location": null,
            "currentlyReading": null
        },
        {
            "id": 297225,
            "name": "Stephen",
            "slug": "stephen",
            "image": null,
            "books": 32,
            "friends": 1,
            "location": null,
            "currentlyReading": null
        },
        {
            "id": 45813,
            "name": "Stephen",
            "slug": "stephen",
            "image": null,
            "books": 47,
            "friends": 13,
            "location": null,
            "currentlyReading": null
        },
        {
            "id": 610906,
            "name": "Stephen",
            "slug": "stephen",
            "image": null,
            "books": 27,
            "friends": 33,
            "location": null,
            "currentlyReading": null
        },
        {
            "id": 386647,
            "name": "Stephen",
            "slug": "stephen",
            "image": null,
            "books": 0,
            "friends": 35,
            "location": null,
            "currentlyReading": null
        },
        {
            "id": 18327,
            "name": "stephen",
            "slug": "stephen",
            "image": null,
            "books": 0,
            "friends": 1,
            "location": null,
            "currentlyReading": null
        },
        {
            "id": 705329,
            "name": "Stephen",
            "slug": "stephen",
            "image": null,
            "books": 13,
            "friends": 4,
            "location": null,
            "currentlyReading": null
        },
        {
            "id": 557652,
            "name": "Stephen",
            "slug": "stephen",
            "image": null,
            "books": 0,
            "friends": 55,
            "location": null,
            "currentlyReading": null
        },
        {
            "id": 449568,
            "name": "Stephen",
            "slug": "stephen",
            "image": null,
            "books": 17,
            "friends": 5,
            "location": null,
            "currentlyReading": null
        },
        {
            "id": 423569,
            "name": "Stephen",
            "slug": "stephen",
            "image": null,
            "books": 0,
            "friends": 1,
            "location": null,
            "currentlyReading": null
        },
        {
            "id": 129243,
            "name": "Stephen",
            "slug": "stephen",
            "image": null,
            "books": 8,
            "friends": 3,
            "location": null,
            "currentlyReading": null
        },
        {
            "id": 118346,
            "name": "Stephen",
            "slug": "stephen",
            "image": null,
            "books": 307,
            "friends": 6,
            "location": null,
            "currentlyReading": null
        },
        {
            "id": 21882,
            "name": "Stephen",
            "slug": "stephen",
            "image": null,
            "books": 0,
            "friends": 1,
            "location": null,
            "currentlyReading": null
        },
        {
            "id": 580266,
            "name": "Stephen",
            "slug": "stephen",
            "image": null,
            "books": 1,
            "friends": 9,
            "location": null,
            "currentlyReading": null
        },
        {
            "id": 579329,
            "name": "Stephen",
            "slug": "stephen",
            "image": null,
            "books": 13,
            "friends": 1,
            "location": null,
            "currentlyReading": null
        },
        {
            "id": 387772,
            "name": "Stephen",
            "slug": "stephen",
            "image": null,
            "books": 33,
            "friends": 5,
            "location": null,
            "currentlyReading": null
        },
        {
            "id": 710417,
            "name": "Stephen",
            "slug": "stephen",
            "image": null,
            "books": 56,
            "friends": 5,
            "location": null,
            "currentlyReading": null
        }
    ]
}
搜索人物 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14964/goodreads+books+api/39256/search+people?q=stephen&page=1' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 Goodreads 图书 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。

标头
标头 描述
授权 必需 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。

(年度计费可节省 2 个月 🎉)

起价
$10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

概览

图书数据:搜索书籍、作者和人物;按ID或ISBN查看书籍详情;相似书籍;按阅读顺序排列的系列;新发行和最受欢迎书籍的类型;书单、名言和获奖作品

Goodreads 图书 API FAQs

每个端点返回特定的图书相关数据。例如,搜索图书端点返回与搜索词匹配的图书列表,而获取图书详情端点提供有关单本书的全面信息,包括作者、类别和评分

关键字段因端点而异。例如,搜索书籍端点包括“id”“name”“authors”和“avgRating”等字段。获取书籍详细信息端点增加了“description”“series”和“buy links”字段,为每本书提供了更丰富的上下文

参数取决于端点 搜索图书端点使用“q”作为搜索词和一个可选的“page” 类型端点使用类型“slug”(例如“非小说”) 列表端点使用列表“slug” 引文搜索使用“q”加上一个可选的“page”

响应数据采用JSON格式结构,通常包含一个主对象和分页信息(例如“页”和“总页数”)以及一个结果数组(例如“图书”或“引用”)。数组中的每个项目都包括相关字段以便于访问

数据来自Goodreads:书籍记录,包括作者、系列、类型和评分,策划的书单和标签、引用、团体和个人,以及年度选择奖

典型的用例包括构建图书推荐系统 创建阅读列表 和分析图书类型的趋势 开发者可以使用API来增强应用程序提供丰富的图书数据 使其能够支持搜索 发现 和用户参与

用户可以通过解析JSON响应来提取相关信息,从而利用返回的数据。例如,他们可以在用户界面中显示书名、作者和评分,或使用类型数据根据用户偏好筛选和推荐书籍

遇到部分或空结果时,请检查“totalResults”字段以了解搜索的范围。实施后备机制,例如建议替代搜索词或显示未找到结果的消息,以提升用户体验

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]

此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

相关 API


您可能还喜欢