Skip to main content

Developers

Dzaleka Encyclopedia API

Public, read-only JSON access to encyclopedia entries, sources, relationships, images, and structured entity data.

Open the APIOpenAPI document

Quick start

No API key required

Send a GET request from a browser, command line, server, or client application. CORS is enabled for public read access.

curl "https://services.dzaleka.com/api/encyclopedia?q=health&perPage=10"
const response = await fetch(
  'https://services.dzaleka.com/api/encyclopedia?type=person&perPage=20'
);
const { data, meta } = await response.json();

Reference

Endpoints

GET/api/encyclopedia

List, search, filter, sort, and paginate entries.

GET/api/encyclopedia/{slug}

Retrieve one complete entry, including Markdown body and sources.

GET/api/encyclopedia/suggest

Return lightweight ranked suggestions for a search interface.

GET/api/encyclopedia/facets

Return counts by category, entry type, status, and initial letter.

Collection query

Filters and pagination

q
Full-text search across title, aliases, summary, category, type, and entry body.
category
Exact category, such as People, Culture, Health, or Institution.
type
Exact entry type: person, organization, place, overview, event, film, book, or topic.
status
reviewed or developing.
featured
true or false.
page
Page number. Defaults to 1.
perPage
Records per page. Defaults to 20 and is capped at 100.
sort
title or updated.
order
asc or desc.
include
Use include=body to add Markdown bodies to collection results. Detail responses always include the body.

Collection responses include meta totals and first, previous, next, and last links. An out-of-range page returns an empty entries array without changing the requested page number.

Linked data

Request Schema.org JSON-LD

Individual records can be returned as entity-focused JSON-LD. Types include Person, Organization, Place, EventSeries, Movie, Book, and DefinedTerm.

curl -H "Accept: application/ld+json" \
  "https://services.dzaleka.com/api/encyclopedia/remy-gakwaya"

Clients that cannot set an Accept header may append ?format=jsonld.

Responsible reuse

Usage, limits, and attribution

Read requests are limited to 60 per minute per IP address. Successful responses are cached for five minutes. Errors use standard HTTP status codes and return a JSON object with status: "error" and a message.

Attribute reused records to Dzaleka Encyclopedia, Dzaleka Online Services and link to the source entry where practical. Review the open license before bulk reuse.

Current service, policy, and population claims can age. Preserve each record's lastReviewed date and inspect its sources before presenting it as current.

All site APIsReport a data issue