This repo is archived due to the shutdown of Pocket.

The readwise gem may be a good alternative.

Ruby API for v3 of the Pocket API (formerly Read It Later)

Written by and previously maintained by @turadg.

Clone the repo and refer to demo-server.rb for examples on how to interact with the Pocket API.

git clone
cd pocket-ruby
bundle install
ruby demo-server.rb

Note: Changes to the demo-server.rb will require a restart to take effect (or you can use rerun).

Pocket-Ruby can be installed via the gem, gem install pocket-ruby

Or via bundler, gem 'pocket-ruby'

Below are some aspects of the Pocket API that aren't covered in the official documentation, or that have been observed:

• For very long articles, the maximum reported word_count is 65535, even if the article is longer.
• If a count isn't specified, the Retreive call will return maximum of 5000 items.
• The API response may contain a number of undocumented fields, including:
  • amp_url
  • domain_metadata
  • is_index
  • lang (ISO_639-1?)
  • listen_duration_estimate
  • sort_id
  • time_to_read
  • top_image_url
• Every integer value is returned as a string, except for time_to_read, listen_duration_estimate and sort_id.
• The time_to_read is in minutes, but listen_duration_estimate is in seconds.
• If an article's status is "2" ('should be deleted') then most fields will not be present.