API

Elk product in de catalogus, in één verzoek:

curl https://www.euromakers.org/api/software

[
  {
    "id": "proton-mail",
    "name": "Proton Mail",
    "description": "End-to-end encrypted email from Switzerland.",
    …
  },
  …
]

• Snapshotbestanden: gratis, leesbaar vanaf elke website, elke nacht opnieuw gemaakt, zonder limieten. Voor browsers en taken met de hele catalogus.
• Live-API: voor je server, zo’n 60 verzoeken per minuut per IP-adres. Voor één product tegelijk en verser data.

De gepubliceerde catalogus als statische JSON-bestanden, elke nacht opnieuw gemaakt. Alleen gewijzigde bestanden worden herschreven, en geen ervan telt mee voor een limiet.

[
  {
    "id": "proton-mail",
    "name": "Proton Mail",
    "description": "End-to-end encrypted email from Switzerland.",
    …
  },
  …
]

["Germany", "France", "Slovakia", "…"]

{
  "artificial-intelligence": 13,
  "cloud": 16,
  "communication": 14
}

[
  {
    "tool": "slack",
    "name": "Slack",
    "page": "https://www.euromakers.org/alternatives/slack",
    "ids": ["element", "rocket-chat", "…"]
  }
]

{
  "version": "v1",
  "generatedAt": "2026-11-12T22:05:00.000Z",
  "docs": "https://www.euromakers.org/developers",
  "license": "Free for any use. Logos belong to their makers, and the directory can’t be resold in bulk.",
  "attribution": "Link back to EuroMakers (https://www.euromakers.org) where you show this data.",
  "terms": "https://www.euromakers.org/terms",
  "files": [
    {
      "name": "software.json",
      "url": "https://data.euromakers.org/v1/software.json",
      "items": "…",
      "bytes": "…",
      "sha256": "…"
    },
    "…"
  ]
}

Vanaf een webpagina:

const response = await fetch("https://data.euromakers.org/v1/software.json");
const products = await response.json();

Elk endpoint beantwoordt GET met JSON. De voorbeeldantwoorden zijn echt maar ingekort.

Elk product heeft deze velden. Optionele velden ontbreken als ze leeg zijn.

id · string

Vast id, ook het einde van het adres van de productpagina.

name · string

Productnaam.

description · string

Beschrijving in één zin.

audience · string[]

Voor wie het is: b2b, individual of beide.

country · string

Land van herkomst.

website · uri

De website van het product.

longDescription · string

Een paar alinea’s over het product.

features · string[]

Belangrijkste functies.

useCases · string[]

Eén tot vier toepassings-id’s.

category · string

Categorie-id, zoals in /categories/{id}.

verified · boolean

optioneel · true als de maker het eigendom heeft bevestigd; anders ontbreekt het.

logoUrl · uri

optioneel · Logo (PNG, JPEG of WebP); ontbreekt als er geen is.

Hetzelfde als TypeScript-types:

export interface Software {
  /** Stable id, also the end of the product’s page address. */
  id: string;
  /** Product name. */
  name: string;
  /** One-sentence description. */
  description: string;
  /** Who it’s for: b2b, individual or both. */
  audience: ("b2b" | "individual")[];
  /** Country of origin. */
  country: string;
  /** The product’s website. */
  website: string;
  /** A few paragraphs about the product. */
  longDescription: string;
  /** Main features. */
  features: string[];
  /** One to four use-case ids. */
  useCases: string[];
  /** Category id, as in /categories/{id}. */
  category: string;
  /** true when the maker verified ownership; absent otherwise. */
  verified?: true;
  /** Logo (PNG, JPEG or WebP); absent when there is none. */
  logoUrl?: string;
}

/** countries.json, GET /api/software/countries */
export type Countries = string[];

/** categories.json, GET /api/categories/counts */
export type CategoryCounts = Record<string, number>;

/** One entry of alternatives.json */
export interface Alternative {
  tool: string;
  name: string;
  page: string;
  ids: string[];
}

Fouten zijn JSON met een melding, een vaste code en een hint:

{
  "code": "not_found",
  "error": "Software not found",
  "hint": "List known ids with GET /api/software, then retry with an existing kebab-case id."
}

60 verzoeken per 60 seconden per IP-adres, gedeeld door alle endpoints, antwoorden uit de cache meegeteld. Boven de limiet krijg je een 429 met de headers Retry-After (in seconden) en X-RateLimit-Limit. Als de API als geheel heel druk is, kan die al 429 geven voordat je je limiet bereikt.

Redelijk gebruik: heb je meer nodig, gebruik dan de snapshotbestanden.

Elk antwoord heeft een ETag. Stuur die terug in If-None-Match, en een ongewijzigd antwoord is een 304 zonder inhoud.

curl -i https://www.euromakers.org/api/software/proton-mail -H 'If-None-Match: "<ETag of the last answer>"'

De live-API stuurt geen CORS-headers, dus een browser op een andere site kan hem niet lezen. Gebruik in een browser de snapshotbestanden: elke website mag die lezen.

Dit is versie 1 van de API en de snapshotbestanden. We voegen alleen toe: geen pad, veld of type verandert of verdwijnt. Een brekende wijziging zou als nieuwe versie naast deze komen.

De API is gratis voor elk gebruik. Link naar EuroMakers waar je de gegevens toont. Logo’s zijn van hun makers, en de catalogus mag niet in zijn geheel worden doorverkocht.

Gebruiksvoorwaarden

• /openapi.json · OpenAPI 3.1-beschrijving van elk endpoint
• /llms.txt · Samenvatting van de site voor taalmodellen
• https://data.euromakers.org/v1/manifest.json · Wanneer de bestanden zijn gemaakt, hoeveel items elk bevat, hun grootte en SHA-256, en de voorwaarden.