{"id":15477781,"url":"https://github.com/bdlukaa/books_finder","last_synced_at":"2025-04-22T14:24:13.021Z","repository":{"id":40372075,"uuid":"290911025","full_name":"bdlukaa/books_finder","owner":"bdlukaa","description":"A library to help on the search for books on google books api","archived":false,"fork":false,"pushed_at":"2023-05-30T23:02:59.000Z","size":68,"stargazers_count":21,"open_issues_count":6,"forks_count":16,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-16T02:59:12.832Z","etag":null,"topics":["books-finder","dart","google-books","google-books-api","google-books-search"],"latest_commit_sha":null,"homepage":"https://pub.dev/packages/books_finder","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bdlukaa.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"patreon":"bdlukaa"}},"created_at":"2020-08-28T00:22:05.000Z","updated_at":"2024-07-26T21:09:48.000Z","dependencies_parsed_at":"2023-02-12T07:16:34.755Z","dependency_job_id":null,"html_url":"https://github.com/bdlukaa/books_finder","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bdlukaa%2Fbooks_finder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bdlukaa%2Fbooks_finder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bdlukaa%2Fbooks_finder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bdlukaa%2Fbooks_finder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bdlukaa","download_url":"https://codeload.github.com/bdlukaa/books_finder/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250256728,"owners_count":21400577,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["books-finder","dart","google-books","google-books-api","google-books-search"],"created_at":"2024-10-02T04:01:27.749Z","updated_at":"2025-04-22T14:24:12.996Z","avatar_url":"https://github.com/bdlukaa.png","language":"Dart","funding_links":["https://patreon.com/bdlukaa"],"categories":[],"sub_categories":[],"readme":"\u003cdiv\u003e\n  \u003ch1 align=\"center\"\u003ebooks_finder\u003c/h1\u003e\n  \u003cp align=\"center\" \u003e\n    \u003ca title=\"Discord\" href=\"https://discord.gg/674gpDQUVq\"\u003e\n      \u003cimg src=\"https://img.shields.io/discord/809528329337962516?label=discord\u0026logo=discord\" /\u003e\n    \u003c/a\u003e\n    \u003ca title=\"Pub\" href=\"https://pub.dartlang.org/packages/books_finder\" \u003e\n      \u003cimg src=\"https://img.shields.io/pub/v/books_finder.svg?style=popout\u0026include_prereleases\" /\u003e\n    \u003c/a\u003e\n    \u003ca title=\"Github License\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/license/bdlukaa/books_finder\" /\u003e\n    \u003c/a\u003e\n  \u003cdiv\u003e\n\u003c/div\u003e\n\nA library to help on the search for books on the [Google Books Api](https://developers.google.com/books/docs/v1/using).\n\n## Usage\n\nFirst of all, import the library:\n\n```dart\nimport 'package:books_finder/books_finder.dart';\n```\n\n### Querying books\n\nTo query books, just call the function `queryBooks`:\n\n```dart\nfinal List\u003cBook\u003e books = await queryBooks(\n 'twilight',\n queryType: QueryType.intitle,\n maxResults: 3,\n printType: PrintType.books,\n orderBy: OrderBy.relevance,\n);\n```\n\nYou can change a few parameters to make your query more specific:\n\n| Parameter          | Description                                | Nullable |\n| ------------------ | ------------------------------------------ | -------- |\n| queryType          | Keywords to search in particular fields    | Yes      |\n| maxResults         | Set the max amount of results              | No       |\n| startIndex         | for pagination                             | No       |\n| langRestrict       | Retrict the query to a specific language   | Yes      |\n| orderBy            | Order the query by newest or relevance     | Yes      |\n| printType          | Filter by books, magazines or both         | Yes      |\n| reschemeImageLinks | Rescheme image urls from `http` to `https` | No       |\n\n### Books\n\nIf you already have a `Book` object, you can call `book.info` to get all the book infos:\n\n```dart\nfinal info = book.info;\n```\n\n| Parameter                                       | Description                                 |\n| ----------------------------------------------- | ------------------------------------------- |\n| title (`String`)                                | Title of the book                           |\n| subtitle (`String`)                             | The subtile of the book                     |\n| authors (`List\u003cString\u003e`)                        | All the authors names                       |\n| publisher (`String`)                            | The publisher name                          |\n| publishedDate (`DateTime`)                      | The date it was published                   |\n| rawPublishedDate (`String`)                     | The date it was published in raw format     |\n| description (`String`)                          | Description of the book                     |\n| pageCount (`int`)                               | The amount of pages                         |\n| categories (`List\u003cString\u003e`)                     | The categories the book is in               |\n| averageRating (`double`)                        | The average rating of the book              |\n| ratingsCount (`int`)                            | The amount of people that rated it          |\n| maturityRating (`String`)                       | The maturity rating                         |\n| contentVersion (`String`)                       | The version of the content                  |\n| industryIdentifier (`List\u003cIndustryIdentifier\u003e`) | The identifiers of the book (isbn)          |\n| imageLinks (`List\u003cMap\u003cString, Uri\u003e\u003e`)           | The links with the avaiable image resources |\n| language (`String`)                             | The language code of the book               |\n\n## Acknowledgements\n\n- [@JimTim](https://github.com/JimTim) for industry identifiers and tests\n- [@Moomink](https://github.com/Moomink) for fixing `startIndex`\n- [@niklasenberg](https://github.com/niklasenberg) for `BookInfo.subtitle` and `QueryType`\n\n## Issues and feedback\n\nPlease file issues, bugs, or feature requests in our [issue tracker](https://github.com/bdlukaa/books_finder/issues/new).\n\nTo contribute a change to this plugin open a [pull request](https://github.com/bdlukaa/books_finder/pulls).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbdlukaa%2Fbooks_finder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbdlukaa%2Fbooks_finder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbdlukaa%2Fbooks_finder/lists"}