---
name: "Catmandu::Importer::Zotero"
section: "3pm"
platform: "linux"
package: "libcatmandu-zotero-perl"
version: "0.07-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Catmandu::Importer::Zotero"
---

# Catmandu::Importer::Zotero(3pm)

Import records from Zotero web

## NAME

Catmandu::Importer::Zotero - Import records from Zotero web

## SYNOPSIS

```
    # From the command line
    # From the command line
    $ catmandu convert Zotero --userID <userID> to JSON
    $ catmandu convert Zotero --groupID <groupID> to JSON

    # From Perl
    use Catmandu;
    my $importer = Catmandu->importer('Zotero', userID => '...');
    $importer->each(sub {
       my $item = shift;
       print "%s %s\n", $item->{_id} , $item->{title}->[0];
   });
```

## CONFIGURATION

- userID

  User identifier (given at \<https://www.zotero.org/settings/keys\>). Required unless `"groupID"` is set.

- groupID

  Group identifier (numeric part of the RSS library feed of a group)

- collectionID

  Collection key (alphanumeric identifier)

- apiKey

  Zotero API key for authenticated access

- sort

  `"dateAdded"`, `"dateModified"` (default), `"title"`, `"creator"`, `"type"`, `"date"`, `"publisher"`, `"publicationTitle"`, `"journalAbbreviation"`, `"language"`, `"accessDate"`, `"libraryCatalog"`, `"callNumber"`, `"rights"`, `"addedBy"`, or `"numItems"`

- direction

  `"asc"` or `"desc"`

- itemKey

  A comma-separated list of item keys. Valid only for item requests. Up to  50 items can be specified in a single request.

- itemType

  Item type search. See \<https://www.zotero.org/support/dev/web\_api/v3/basics#search\_syntax\> for boolean search syntax.

- q

  Quick search to search titles and individual creator fields, or all fields if qmode is set to `"everything"`.

- qmode

  `"titleCreatorYear"` (default) or `"everything"`

- since

  Return only objects modified after the specified library version.

- tag

  Tag search. Supports Boolean search like item type search.

## DESCRIPTION

This Catmandu::Importer imports bibliographic data from Zotero \<https://www.zotero.org\> reference management service.

## SEE ALSO

WWW::Zotero, Catmandu::Importer, Catmandu::Iterable