abetoluwani/african-languages
Domain:
natural language processingRecord type:
dataset
Creator:
abe
Host:
# African Languages Dataset & API
This repository provides a comprehensive dataset and a **Static API** of African languages
## Contents
- `api/v1/`: The automatically generated Static JSON API ready for use.
- `african_languages.csv`: The filtered CSV dataset containing languages from the "Africa" macroarea.
- `build_api.py`: Python script that reverse-geocodes the coordinates and builds the Static API.
- `extract.py`: Python script used to extract African languages from the original Glottolog dataset.
## Using the Static API
This repository acts as a highly available, zero-latency static API hosted via GitHub Pages. You can fetch the JSON endpoints directly in your application!
Base URL: `abetoluwani.github.io`
### Endpoints
- **GET `/languages.json`**: Returns an array of **all** African languages and dialects.
- **GET `/countries.json`**: Returns an array of all available country codes (e.g. `["ng", "za", ...]`).
- **GET `/summary.json`**: Returns metrics on the dataset (total languages, dialects, countries).
- **GET `/country/{country_code}.json`**: Returns an array of all languages spoken in a specific country. (Example: `/country/ng.json` for Nigeria).
- **GET `/language/{glottocode}.json`**: Returns the details for a single specific language. (Example: `/language/aari1239.json`).
### Examples (JavaScript)
**1. Fetch all African languages (The entire dataset at once)**
```javascript
fetch("abetoluwani.github.io")
.then(res => res.json())
.then(data => console.log(`Loaded ${data.length} languages!`));
```
**2. Fetch all languages spoken in a specific country (e.g., Nigeria)**
```javascript
fetch("abetoluwani.github.io")
.then(res => res.json())
.then(data => console.log(data));
```
**3. Fetch details for a single specific language (e.g., Aari)**
```javascript
fetch("abetoluwani.github.io …