Dati e API

Il database BlackItaly è un dato di ricerca aperto. Questa pagina dice con quale licenza potete riusarlo, come citarlo e come leggerlo in modo automatico.

Licenza

I dati del database (schede delle persone, delle reti e dei luoghi, con le loro relazioni) sono pubblicati con licenza Creative Commons Attribuzione 4.0 Internazionale (CC BY 4.0): potete copiarli, ridistribuirli e rielaborarli, anche per scopi commerciali, a condizione di citare la fonte. I testi delle pagine del sito e le immagini restano soggetti ai diritti indicati caso per caso. Il riuso dei dati che riguardano persone identificabili resta soggetto alle Regole deontologiche per i trattamenti a fini di ricerca storica richiamate all'ingresso del sito.

Come citare

Il database: BlackItaly. The Italian Peninsula and the Atlantic Slavery: a Forgotten History, database, Fondazione Bruno Kessler – Istituto Storico Italo-Germanico, Trento, https://blackitaly.fbk.eu (consultato il giorno/mese/anno).

Una singola scheda: titolo della scheda, in BlackItaly, indirizzo della scheda. Per esempio: «La Chiapella Geronimo», in BlackItaly, https://blackitaly.fbk.eu/s/ita/item/748.

API

Il sito è costruito con Omeka S e ne espone l'API REST, in sola lettura e senza registrazione, all'indirizzo https://blackitaly.fbk.eu/api. Le risposte sono in JSON-LD (il contesto è in /api-context); i risultati sono paginati con i parametri page e per_page. Alcuni esempi:

  • tutte le persone del database: /api/items?item_set_id=86&resource_class_id=94
  • una scheda: /api/items/748
  • le reti: /api/items?item_set_id=1204
  • le persone di una rete (qui la 1212): /api/items?property[0][property]=298&property[0][type]=res&property[0][text]=1212
  • ricerca a testo libero: /api/items?fulltext_search=Grillo
  • i marker della mappa: /api/mapping_features
  • i campi propri di BlackItaly: /api/properties?vocabulary_prefix=blackitaly (vocabolario https://blackitaly.fbk.eu/blackitaly/)

Documentazione dell'API: omeka.org/s/docs/developer/api.

Che cosa è escluso

L'API restituisce soltanto i dati pubblici. Non sono accessibili le note di lavoro del gruppo di ricerca, le schede ancora in revisione e, fino a gennaio 2027, le schede delle navi e dei viaggi. Il database documenta le persone della penisola italiana coinvolte nella tratta atlantica come mercanti, finanziatori, armatori, capitani e proprietari; non raccoglie schede sulle persone schiavizzate, che compaiono solo quando le fonti le nominano accanto a chi le teneva in schiavitù.

Scaricare tutto il database

Una copia completa del database (CSV e JSON-LD), con un DOI che ne fissa la versione, verrà depositata in un archivio aperto a ogni rilascio; il primo deposito è in preparazione. Nel frattempo i dati si estraggono dall'API.

Contatti

Segnalazioni, correzioni e richieste sul riuso dei dati: fmorelli@fbk.eu.