Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

API wrapper for the Zotero API

branch: master

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 .yardoc
Octocat-spinner-32 examples
Octocat-spinner-32 faraday
Octocat-spinner-32 lib
Octocat-spinner-32 spec
Octocat-spinner-32 .gitignore
Octocat-spinner-32 Gemfile
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.rdoc
Octocat-spinner-32 ROADMAP.rdoc
Octocat-spinner-32 Rakefile


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.