Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
API wrapper for the Zotero API
branch: master
Failed to load latest commit information.
.yardoc move from jeweler to bundler packaging method
examples move from jeweler to bundler packaging method
faraday moving stuff around
lib updated version
.gitignore Initial commit of framework
Gemfile move from jeweler to bundler packaging method
LICENSE new version of the code
README.rdoc move from jeweler to bundler packaging method
ROADMAP.rdoc Starting to migrate in to new Zotero modules with updated api
Rakefile move from jeweler to bundler packaging method



A simple, extensible Ruby client for the Zotero API.


gem install rzotero


rzotero uses the Nokogiri gem to parse the RSS feed from Zotero


Zotero requires private keys for accessing your non-private data. You can request a key from Zotero


The Zotero API currently requires your user ID (not your user name) to properly construct the API call. If you need to look up your user id, head over to Zotero ID Finder

require 'rubygems'
require 'rzotero'

zotero =, 'api_key')

puts zotero.user
puts zotero.key
puts zotero.items
puts zotero.item(2)
puts zotero.collections
puts zotero.collection(1)

Note on Patches/Pull Requests

  • Fork the project.

  • Make your feature addition or bug fix.

  • Add tests for it. This is important so I don't break it in a future version unintentionally.

  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)

  • Send me a pull request. Bonus points for topic branches.


Copyright © 2010 Wayne Graham. See LICENSE for details.

Something went wrong with that request. Please try again.