API & Data Access

Static API - Accessing Tutorial Data

The Tutorial Collection provides open access to the complete dataset through static JSON files.

Base URL

All API endpoints are served as static files from the data directory:

https://tutorial-collection-b122dd.pages.gwdg.de/data/

Available Endpoints

Complete Dataset

Endpoint: /data/tutorials-full.json

Complete collection of all tutorials with all metadata fields.

Language-Specific Exports

Filter by tutorial language:

• German: /data/tutorials-de.json
• English: /data/tutorials-en.json
• French: /data/tutorials-fr.json

Difficulty-Level Exports

Filter by difficulty level:

• Low: /data/tutorials-difficulty-low.json
• Intermediate: /data/tutorials-difficulty-intermediate.json
• Advanced: /data/tutorials-difficulty-advanced.json

Media Type Exports

Filter by content format:

• Text: /data/tutorials-media-text.json
• Video: /data/tutorials-media-video.json
• Audio: /data/tutorials-media-audio.json
• Image: /data/tutorials-media-image.json
• Other: /data/tutorials-media-other.json

Combined Filters

Combine language and difficulty level:

• /data/tutorials-en-advanced.json
• /data/tutorials-de-low.json
• /data/tutorials-de-intermediate.json
• /data/tutorials-en-intermediate.json
• /data/tutorials-en-low.json
• /data/tutorials-de-advanced.json
• /data/tutorials-fr-advanced.json

Data Schema

Endpoint: /data/schema.json

Complete documentation of the data structure, including field descriptions, data types, valid values, and collection statistics.

Fields:

Field	Type	Description
id	string	Unique identifier (e.g., ttp00001)
title	string	Tutorial title
contributor	string	Author(s)
mediaType	string	Format: Text, Video, Audio, Image, Other
learningResourceType	string	Type of learning resource
targetGroup	array	Target audience (Bachelor, Master, PhD, Data Steward)
difficulty	string	Level: Low, Intermediate, Advanced
license	string	License information
dateVersion	string	Publication/update date (YYYY-MM-DD)
language	string	Language code (de, en, fr)
description	string	Complete tutorial description
keywords	string	Keywords separated by semicolons
learningObjective	array	Learning objectives
url	string	Link to the tutorial
provenance	string	Source of the tutorial
peerReviewed	string	Peer review status
registrationRequired	boolean	Whether registration is required
relatedTo	string	Related tutorial IDs

Response Format

All endpoints return JSON with the following structure:

{
  "metadata": {
    "generated": "2026-03-04T17:10:00.000000",
    "description": "Tutorials in English",
    "version": "1.0",
    "count": 143
  },
  "data": [
    {
      "id": "ttp00001",
      "title": "Analyzing Documents with TF-IDF",
      "contributor": "Matthew J. Lavin",
      ...
    },
    ...
  ]
}

Metadata Fields

• generated: ISO 8601 timestamp of when the export was generated
• description: Human-readable description of the dataset
• version: API/schema version
• count: Number of tutorials in this export

License

The Tutorial Collection is made available under the Creative Commons Attribution 4.0 International License (CC-BY-4.0), unless otherwise specified in the individual tutorial entries.

Support

For questions or issues with the API, please contact:

Text+ Helpdesk