# Get entities

## Summary

<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->

- [By ids](#by-ids)
  - [Get many entities by ids](#get-many-entities-by-ids)
  - [By id and revision](#by-id-and-revision)
- [By Sitelinks](#by-sitelinks)

<!-- END doctoc generated TOC please keep comment here to allow auto update -->


## By ids
*associated Wikibase API doc: [wbgetentities](https://www.wikidata.org/w/api.php?action=help&modules=wbgetentities)*

```js
const url = wbk.getEntities({
  ids: [ 'Q1', 'Q5', 'Q571' ],
  languages: [ 'en', 'fr', 'de' ], // returns all languages if not specified
  props: [ 'info', 'claims' ], // returns all props if not specified
  format: 'xml', // default: json
  redirections: false // default: true
})
```

Example using [`fetch`](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/fetch) to make the HTTP request:
```js
const url = wbk.getEntities({
  ids: [ 'Q647268', 'Q771376', 'Q860998', 'Q965704' ],
  language: user.language
})
const { entities } = await fetch(url).then(res => res.json())
// Do your thing with those entities data)
```


### Get many entities by ids
Above 50 ids, `wbk.getEntities` will warn you that your request won't be fully fullfiled by Wikidata API due to its limitations policy.
You can use `wbk.getManyEntities` instead to generate several request urls to work around this limitation:

The arguments API is the same as getEntities:
```js
const urls = wbk.getManyEntities({
  ids: [ 'Q1', 'Q2', 'Q3', ..., 'Q123' ],
  languages: [ 'en', 'fr', 'de' ],
  props: [ 'info', 'claims' ],
  format: 'json',
  redirections: false // default: true
})
```
but it returns an array of urls instead.

:warning: This limitation policy was probably there for a reason, right? This should be the exception, make sure to set an interval between your requests (500ms, 1s?), and if you really need a lot of entities, consider using [dumps](https://www.wikidata.org/wiki/Wikidata:Database_download#JSON_dumps_.28recommended.29): there are [great tools](https://codeberg.org/maxlath/wikibase-dump-filter) to work with those too! ;)


### By id and revision
At some point in your love story with Wikidata, you might end up needing to access data from an entity at a different revision than the current one, so there's a function for that:
```js
const url = wbk.getEntityRevision({ id: 'Q3548931', revision: 775908525 })
```

The revision id can be obtained using [`wbk.getRevisions`](https://codeberg.org/maxlath/wikidata-sdk/src/branch/main/docs/get_revisions.md#get-revisions): look for the `revid`.

The returned data can then be [simplified](https://codeberg.org/maxlath/wikidata-sdk/src/branch/main/docs/simplify_entities_data.md#simplify-entities-data) as for normal entity data.

## By Sitelinks
*associated Wikibase API doc: [wbgetentities](https://www.wikidata.org/w/api.php?action=help&modules=wbgetentities)*

Typical usecase: you're working with a list of Wikipedia articles in a given language and would like to move to Wikidata for all the awesomeness it provides: you can fetch the entities on Wikidata using the Wikipedia articles titles:
```js
const url = wbk.getEntitiesFromSitelinks({ titles: 'Hamburg' })
//=> 'https://www.wikidata.org/w/api.php?action=wbgetentities&titles=Hamburg&sites=enwiki&format=json'

const url = wbk.getEntitiesFromSitelinks({ titles: [ 'Hamburg', 'London', 'Lisbon' ] })
// => 'https://www.wikidata.org/w/api.php?action=wbgetentities&titles=Hamburg%7CLyon%7CBerlin&sites=enwiki&format=json'
```

By default, it looks in the English Wikipedia, but we can change that:
```js
const url = wbk.getEntitiesFromSitelinks({
  titles: 'Hamburg',
  sites: 'enwikivoyage', // default: enwiki
  languages: [ 'en', 'fr', 'de' ],
  props: [ 'info', 'claims' ],
  format: 'json', // default: json
  redirections: false // default: true
})
```