APIs

Finding related content

Several components can ideally display content from sources across the web. The goal is to make available tools to enrich Wikimedia projects with then.

Selecting data for the query

• Labels and aliases in all languages
  • Not all languages can be handled by an API. The unsuitable ones need to be filtered our in the preprocessing phase.
  • If the main languages of the API are known, the query can use labels of that language as a primary option.
  • Preprocessing can collect all necessary values and send to the local API. The local component for a specific API can arrange the data suitable for each API, for example concatenate the query strings in different ways, using AND or OR.
• Item's location can be used to narrow down search results or to distinguish from namesakes.
• The dates of the item can be used to narrow down search results. This is especially useful with maps.
• For maps the zoom level or the scale can be calculated using the size of the area the item covers.

Metadata roundtripping

1. GLAM makes available images and their metadata through their public API. Wikidocumentaries uses many properties from the current topic to query that.
2. When reading the data through the Wikidocumentaries API, the metadata is normalized using a different transformation for each GLAM.
3. The metadata from different GLAMs is displayed in a uniform format in the Wikidocumentaries metadata display.
4. When an image is saved to Wikimedia projects, users can reconcile string values with Wikidata items. String values can be saved as well, they will be available for reconciling later.
5. In the Wikidocumentaries metadata interface, the string values are replaced by reconciled Wikidata items. Differences between the source data from the GLAM and Wikidata, such as recent changes in the GLAM's metadata, can also be highlighted.
6. Maybe the GLAM could query Wikidocumentaries for changed information?

Consolidate data from different sources for the same item

Especially if Wikidocumentaries decides to store images or their metadata locally, these scenarios become available. Similar images from different sources can be detected. Their metadata can be compared, and the user is asked to verify the correct information. The updated data is saved in the central repository (Wikimedia Commons) with a reference to the source that provided this information. One of the information types that can be compared is the copyright status.

Search criteria for different media types

Images

Image search is ideally based on

• Item label in the current language > must be changed to read the most suitable label.
• Native label
• Aliases > Which languages
• Item location > must be made more contextual
• Item date

Digitized maps

• Date
• Names of historical administrative entities
• Zoom level / scale

Wikimedia APIs

• MediaWiki API
  • https://www.mediawiki.org/wiki/API:Tutorial
  • https://en.wikipedia.org/w/api.php Wikipedia API help

• Wikidata
  • Wikidata Query Service - SPARQL
  • Wikidata API help - MediaWiki API

Image APIs

• Wikimedia Commons
  • Wikimedia Commons API help - MediaWiki API
• Finna.fi
  • Images from Finnish museums
  • Publications from Finnish libraries
  • Documentation
    • Finna API documentation
    • Old but still somewhat useful Finna API documentation
    • CC licensing data available, prepared for RightsStatements
• Europeana
• Flickr
  • Flick API Docs - Includes useful API Explorer
• Smithsonian
• Paris Musées
• Creative Commons Search, Openverse
• Internet Archive
• Ajapaik
  • Ajapaik.ee
• Topothek
  • Images from Topotheks submitted by local people
• K-Samsök

Data APIs

• Nimiarkisto.fi
• Linked Data Finland
  • BiographySampo
  • SotaSampo
• FIN-CLARIN

Map APIs

• Map Warper
  • Map Warper API documentation

Navigation

About	Technology	Design	Content modules	Tool pages	Projects
Status Wikidocumentaries blog Wikidocumentaries demo Phabricator project Facebook group GitHub repository Translation in TranslateWiki Wikidocumentaries Slack	Setting up dev environment Resources Translations Languages Using Wikibase Federation with Wikidata APIs Linking Media metadata Properties to content User registration Licensing	Page types Landing page Search page Topic page User page Organisation page Project page Tool page Tasks Components Main toolbar and footer Search Faceting Topic page header Content module Dropdown Modal Icons	Active modules Article Family tree Gallery Historical map Images Image viewer Infobox Map Module ideas Audio/Video Bibliography Correspondence Discussion Graph Name Newspaper articles Testimonials Timeline Visualizations Wikidocumentary 3D	Visual editor Query tool QuickStatements Open Refine Creating topics Uploading images Geolocating tool Metadata editor Rectifying maps Transcription Annotation tool	Central Park Archives Convent Quarter Wikisource