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

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

Import from Wikidata

## NAME

Catmandu::Importer::Wikidata - Import from Wikidata

## VERSION

version 0.06

## SYNOPSIS

```
    catmandu convert Wikidata --ids Q1,P227
    catmandu convert Wikidata --site dewiki --title Wahnsinn
    echo Q1 | catmandu convert Wikidata
    echo Wahnsinn | catmandu convert Wikidata --site dewiki
    echo dewiki:Wahnsinn | catmandu convert Wikidata
    echo Q1 | catmandu convert Wikidata --fix 'retain_field("labels")'
```

## DESCRIPTION

This Catmandu::Importer queries Wikidata for entities, given by their Wikidata identifier (`"Q..."`, `"P..."`) or by a title in some know Wikidata site, such as the English Wikipedia (`"enwiki"`). The entities are either specified as options (`"ids"`, `"site"`, and/pr `"title"`) or as line-separated input values. By default, the raw JSON structure of each Wikidata entity is returned one by one. Entities not found are returned with the `"missing"` property set to `1` like this:

```
    { "id": "Q7", "missing": "1" }
```

To further process the JSON structure Catmandu::Wikidata contains several Catmandu fixes, e.g. to only retain a selected language.

## CONFIGURATION

This importer extends Catmandu::Importer::getJSON, so it can be configured with options `"agent"`, `"timeout"`, `"headers"`, `"proxy"`, and `"dry"`. Additional options include:

- api

  Wikidata API base URL. Default is `"http://www.wikidata.org/w/api.php"`.

- ids

  A list of Wikidata entitiy/property ids, such as `"Q42"` and `"P19"`. Use comma, vertical bar, or space as separator. Read from input stream if no ids, nor titles are specified.

- site

  Wiki site key for referring to Wikidata entities by title. Default is `"enwiki"` for English Wikipedia. A list of supported site keys can be queried as part of \<https://www.wikidata.org/w/api.php?action=paraminfo&modules=wbgetentities\> (unless \<https://bugzilla.wikimedia.org/show\_bug.cgi?id=58200\> is fixed).

- title

  Title of a page for referring to Wikidata entities. A title is only unique within a selected `"site"`. One can also prepend the site key to a title separated by colon, e.g. `"enwiki:anarchy"` for the entity that is titled "anarchy" in the English Wikipedia. Read from input stream if no titles, nor ids are specified.

## AUTHOR

Jakob Voß

## COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by Jakob Voß.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.