{"id":16380990,"url":"https://github.com/anthonator/ar-book-finder","last_synced_at":"2026-03-05T11:04:04.705Z","repository":{"id":11313468,"uuid":"13732547","full_name":"anthonator/ar-book-finder","owner":"anthonator","description":null,"archived":false,"fork":false,"pushed_at":"2013-10-29T23:53:08.000Z","size":212,"stargazers_count":6,"open_issues_count":1,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2026-02-15T12:13:46.968Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/anthonator.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-10-21T03:54:15.000Z","updated_at":"2023-11-02T10:17:54.000Z","dependencies_parsed_at":"2022-09-01T06:31:48.186Z","dependency_job_id":null,"html_url":"https://github.com/anthonator/ar-book-finder","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/anthonator/ar-book-finder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anthonator%2Far-book-finder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anthonator%2Far-book-finder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anthonator%2Far-book-finder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anthonator%2Far-book-finder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anthonator","download_url":"https://codeload.github.com/anthonator/ar-book-finder/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anthonator%2Far-book-finder/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30121090,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T10:44:24.758Z","status":"ssl_error","status_checked_at":"2026-03-05T10:44:15.079Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2024-10-11T03:53:04.749Z","updated_at":"2026-03-05T11:04:04.676Z","avatar_url":"https://github.com/anthonator.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ARBookFinder\n\nRetrieve book data from [arbookfind.com](http://www.arbookfind.com)\n\n[![Gem Version](https://badge.fury.io/rb/ar_book_finder.png)](http://badge.fury.io/rb/ar_book_finder) [![Build Status](https://travis-ci.org/anthonator/ar-book-finder.png?branch=master)](https://travis-ci.org/anthonator/ar-book-finder) [![Dependency Status](https://gemnasium.com/anthonator/ar-book-finder.png)](https://gemnasium.com/anthonator/ar-book-finder) [![Coverage Status](https://coveralls.io/repos/anthonator/ar-book-finder/badge.png)](https://coveralls.io/r/anthonator/ar-book-finder) [![Code Climate](https://codeclimate.com/github/anthonator/ar-book-finder.png)](https://codeclimate.com/github/anthonator/ar-book-finder)\n\n## Installation\n\nAdd this line to your application's Gemfile:\n\n    gem 'ar_book_finder'\n\nAnd then execute:\n\n    $ bundle\n\nOr install it yourself as:\n\n    $ gem install ar_book_finder\n\n### PhantomJS\nThis gem utilizes [PhantomJS](http://phantomjs.org/) for interacting with [arbookfind.com](http://www.arbookfind.com). Make sure to [install PhantomJS](http://phantomjs.org/download.html) in order to use this gem.\n\n## Configuration\nChoose what type of user to peform searches as.\n\nAvailable types include:\n * ```:student```\n * ```:parent```\n * ```:teacher```\n * ```:librarian```\n\nThese types match up to the available user types [here](http://www.arbookfind.com/usertype.aspx).\n```ruby\nARBookFinder.configure do |config|\n  config.user_type = :teacher\nend\n```\n\n## What data is returned?\nThe ARBookFinder gem is capable or returning any data located on a book's [detail](http://www.arbookfind.com/bookdetail.aspx?q=26759\u0026l=EN\u0026slid=431859594) page.\n\nThis includes:\n * cover\n * title\n * author\n * summary\n * ar_quiz_number\n * language\n * ar_quiz_availability\n * atos_book_level\n * interest_level\n * ar_points\n * rating\n * word_count\n * type\n * topics\n * series\n * url\n \nAnd publisher details:\n * name\n * lccn\n * isbn\n * year_published\n * page_count\n\n## Usage\n\n### Quick Search\nQuick search will allow you to perform searches based on title, topics, author or ISBN.\n\nPerform a quick search...\n```ruby\nresults = ARBookFinder.search('harry potter')\nresults.page_count # Retrieve the number of pages this search returns\nresults.books # Retrieve the books returned on this page\n```\nLoad book data on demand using ```#fetch```...\n``` ruby\n...\nbook = results.book[0]\nbook.fetch # Retrieve book data\nbook.title\nbook.author\n...\n```\nReturn publisher data...\n```ruby\n...\npublisher = book.publishers[0]\npublisher.name\npublisher.isbn\n...\n```\n\n### Collections\nCollections will retrieve books lists. Examples include awards, state lists, etc.\n\nRetrieve a collection...\n```ruby\nresults = ARBookFinder.collection({ 'Awards' =\u003e 'ALA Notable/Best Books' })\n```\n\nRetrieve a collection with a multi-level hash...\n```ruby\nresults = ARBookFinder.collection({ 'State Lists' =\u003e { 'Indiana' =\u003e 'IN Young Hoosier Middle Grades Book Award Nominees 2013-2014' } })\n```\n\n### Pagination\nIt's also possible to paginate search results.\n```ruby\n# Retrieve results for page 2\nresults = ARBookFinder.search('harry potter', 2)\nresults.current_page # should == 2\n```\n\n## Contributing\n\n1. Fork it\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Add some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create new Pull Request\n\n## Credits\n[![Sticksnleaves](http://sticksnleaves-wordpress.herokuapp.com/wp-content/themes/sticksnleaves/images/snl-logo-116x116.png)](http://www.sticksnleaves.com)\n\nARBookFinder is maintained and funded by [Sticksnleaves](http://www.sticksnleaves.com)\n\nThanks to all of our [contributors](https://github.com/anthonator/ar-book-finder/graphs/contributors)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanthonator%2Far-book-finder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanthonator%2Far-book-finder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanthonator%2Far-book-finder/lists"}