Skip to main content
Platform operators can import large National Gallery of Art Open Data slices into a project with the same durable batch ledger used by Zenodo bulk imports. Use this workflow for demo or backfill runs that are larger than the interactive Import from NGA page. NGA imports create metadata-first artwork assets. Dataerai stores the artwork metadata and link-out URLs; it does not copy IIIF images into the project’s allocation.

​
Start from the admin page

System administrators can open Import Repositories, choose National Gallery of Art, provide the batch parameters, and click Stage and run. The browser flow stages the same durable BulkImportBatch rows as the management command and then starts run_bulk_import_batch for the new batch. Use the browser form for normal operator starts. Use the commands below when you need dry-run counts, shell access, resume/retry control, or recovery after a web process stops.

​
Stage from the snapshot

Build or reuse the local NGA Open Data snapshot, then stage object IDs:
The command creates a BulkImportBatch with provider=nga and one BulkImportRecord per staged object ID. By default, it skips NGA assets already materialized in the target project. Pass --include-existing-assets only when you intentionally want to revisit existing rows. Useful staging options:

​
Run the batch

Drain staged records through the shared import path:
The runner calls the same sync_import_page body used by scheduled imports, one NGA object ID at a time. It records each row as imported, updated, unchanged, skipped, gone, or failed. If a process stopped mid-run, resume safely:

​
Monitor progress

Check a batch:
For JSON output:
The status payload includes project_source_assets, which reports target project asset counts, distinct NGA object IDs, and staged records that have materialized as AssetContent.source = "nga".

​
Metadata keys

Imported NGA assets keep provider provenance in metadata.source = "nga", but the artwork fields are unprefixed:
  • object_id
  • accession_number
  • classification
  • medium
  • artists
  • styles
  • iiif_image_url
  • iiif_thumbnail_url
  • object_page_url