API Documentation

Introduction

The Glossarium Græco-Arabicum API provides programmatic access to our lexical database of medieval Arabic translations from Greek. The API follows REST principles and returns data in JSON format.

Base URL: https://glossga.bbaw.de/api

Main Endpoints

Words

GET /api/words

List all words with pagination

GET /api/words/{id}

Get single word by ID

GET /api/words/greek

List Greek words

GET /api/words/greek/{letter}

List Greek words by letter

GET /api/words/arabic

List Arabic words

GET /api/words/arabic/{letter}

List Arabic words by letter

GET /api/words/arabic/roots

List Arabic root combinations

GET /api/words/arabic/roots/{position}/{root}

List words by Arabic root at specific position (1-5)

Part of Speech

GET /api/words/pos/greek

List Greek POS categories

GET /api/words/pos/greek/{id}

List words by Greek POS

GET /api/words/pos/arabic

List Arabic POS categories

GET /api/words/pos/arabic/{id}

List words by Arabic POS

Filecards

GET /api/filecards

List all filecards

GET /api/filecards/{id}

Get single filecard with image URL

Sources

GET /api/sources

List all sources with author information

GET /api/sources/{id}

Get single source with detailed metadata

GET /api/words/sources

List sources with word counts

GET /api/words/sources/{id}

List words by source

Authors

GET /api/authors

List all authors with their sources

GET /api/authors/{id}

Get single author with biographical data

Response Format

All list endpoints return data with consistent structure including metadata, pagination links, and the actual data array:

{
  "meta": {
    "total": 1000,
    "per_page": 100,
    "current_page": 1,
    "last_page": 10,
    "from": 1,
    "to": 100
  },
  "links": {
    "first": "https://glossga.bbaw.de/api/words?page=1",
    "last": "https://glossga.bbaw.de/api/words?page=10",
    "prev": null,
    "next": "https://glossga.bbaw.de/api/words?page=2"
  },
  "data": [...]
}

Pagination

Control pagination using query parameters:

  • page: Page number (default: 1)
  • limit: Items per page (default: 100, max: 500)

Example Usage

curl "https://glossga.bbaw.de/api/words/greek/α?page=1&limit=50"

Explore the API

Visit the interactive API index to explore all available endpoints and their documentation:

Open API Index