API

Bezplatné JSON API len na čítanie, pre zverejnený katalóg. Bez kľúča.

Rýchly štart

Všetky produkty z katalógu jednou požiadavkou:

curl https://www.euromakers.org/api/software
[
  {
    "id": "proton-mail",
    "name": "Proton Mail",
    "description": "End-to-end encrypted email from Switzerland.",
    …
  },
  …
]

Ktoré použiť?

  • Súbory snapshot: zadarmo, čitateľné z akéhokoľvek webu, každú noc znova zostavené, bez limitov. Pre prehliadače a úlohy s celým katalógom.
  • Živé API: pre váš server, asi 60 požiadaviek za minútu na IP adresu. Pre jeden produkt naraz a čerstvejšie dáta.

Súbory snapshot

Zverejnený katalóg ako statické súbory JSON, každú noc znova zostavené. Prepisujú sa len zmenené súbory a žiadny sa nepočíta do limitu.

https://data.euromakers.org/v1/software.json

Pole produktov zoradené podľa id kategórie a potom podľa id. Rovnaký JSON ako GET /api/software.

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

https://data.euromakers.org/v1/countries.json

Pole názvov krajín, každý raz, v poradí katalógu (nezoradené). Rovnaký JSON ako GET /api/software/countries.

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

https://data.euromakers.org/v1/categories.json

Objekt z id kategórie na počet produktov. Kategórie bez produktov chýbajú. Rovnaký JSON ako GET /api/categories/counts.

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

https://data.euromakers.org/v1/alternatives.json

Známe nástroje, každý s ID produktov na rovnakú prácu, ako na stránkach nástrojov.

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

https://data.euromakers.org/v1/manifest.json

Kedy súbory vznikli, koľko položiek každý obsahuje, ich veľkosť a SHA-256 a podmienky.

{
  "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": "…"
    },
    "…"
  ]
}

Z webovej stránky:

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

Endpointy

Každý endpoint odpovedá na GET vo formáte JSON. Ukážkové odpovede sú skutočné, ale skrátené.

GET /api/software

Pole produktov zoradené podľa id kategórie a potom podľa id.

Parametre

Žiadne

Príklad
curl https://www.euromakers.org/api/software
Odpoveď
[
  {
    "id": "proton-mail",
    "name": "Proton Mail",
    "description": "End-to-end encrypted email from Switzerland.",
    …
  },
  …
]
Chyby

429 · 500 · 503

Cache

Uchované na okraji siete až 24 hodín a vymazané, keď sa katalóg zmení. s-maxage=86400

GET /api/software/{id}

Jeden produkt. Neznáme alebo nezverejnené id vráti 404.

Parametre
  • id · string · path · povinnýId produktu: malé písmená, číslice a pomlčky. ^[a-z0-9-]{1,80}$
Príklad
curl https://www.euromakers.org/api/software/proton-mail
Odpoveď
{
  "id": "proton-mail",
  "name": "Proton Mail",
  "description": "End-to-end encrypted email from Switzerland.",
  "audience": ["b2b", "individual"],
  "country": "Switzerland",
  "website": "https://proton.me/mail",
  "longDescription": "Proton Mail is the flagship encrypted email …",
  "features": ["End-to-end encrypted email", "…"],
  "useCases": ["business-email"],
  "category": "communication"
}
Chyby

404 · 429 · 500

Cache

Uchované na okraji siete až 24 hodín a vymazané, keď sa katalóg zmení. s-maxage=86400

GET /api/software/countries

Pole názvov krajín, každý raz, v poradí katalógu (nezoradené).

Parametre

Žiadne

Príklad
curl https://www.euromakers.org/api/software/countries
Odpoveď
["Germany", "France", "Slovakia", "…"]
Chyby

429 · 500 · 503

Cache

Uchované na okraji siete až 24 hodín a vymazané, keď sa katalóg zmení. s-maxage=86400

GET /api/categories/counts

Objekt z id kategórie na počet produktov. Kategórie bez produktov chýbajú.

Parametre

Žiadne

Príklad
curl https://www.euromakers.org/api/categories/counts
Odpoveď
{
  "artificial-intelligence": 13,
  "cloud": 16,
  "communication": 14
}
Chyby

429 · 500 · 503

Cache

Uchované na okraji siete až 24 hodín a vymazané, keď sa katalóg zmení. s-maxage=86400

Produkt

Každý produkt má tieto polia. Voliteľné sa vynechávajú, keď sú prázdne.

id · string
Stále id, zároveň koniec adresy stránky produktu.
name · string
Názov produktu.
description · string
Opis v jednej vete.
audience · string[]
Pre koho je: b2b, individual alebo oboje.
country · string
Krajina pôvodu.
website · uri
Web produktu.
longDescription · string
Pár odsekov o produkte.
features · string[]
Hlavné funkcie.
useCases · string[]
Jedno až štyri id prípadov použitia.
category · string
Id kategórie, ako v /categories/{id}.
verified · boolean
voliteľné · true, keď tvorca overil vlastníctvo; inak chýba.
logoUrl · uri
voliteľné · Logo (PNG, JPEG alebo WebP); chýba, ak žiadne nie je.

To isté ako typy TypeScriptu:

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[];
}

Chyby

Chyby sú JSON so správou, stálym kódom a radou:

{
  "code": "not_found",
  "error": "Software not found",
  "hint": "List known ids with GET /api/software, then retry with an existing kebab-case id."
}
StavKódKedy
404not_foundNeznáme id alebo na tejto ceste nie je žiadny endpoint.
429rate_limitedPrekročený limit požiadaviek.
500internal_errorNiečo sa pokazilo na našej strane.
503catalog_unavailableKatalóg sa nepodarilo načítať.

Limity požiadaviek

60 požiadaviek za 60 sekúnd na IP adresu, spoločne pre všetky endpointy, vrátane odpovedí z cache. Nad limitom dostanete 429 s hlavičkami Retry-After (v sekundách) a X-RateLimit-Limit. Keď je API ako celok veľmi vyťažené, môže odpovedať 429 skôr, než dosiahnete svoj limit.

Férové používanie: ak potrebujete viac, použite súbory snapshot.

Podmienené požiadavky

Každá odpoveď nesie ETag. Pošlite ho späť v If-None-Match a nezmenená odpoveď bude 304 bez obsahu.

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

CORS

Živé API neposiela hlavičky CORS, takže prehliadač na inom webe ho neprečíta. V prehliadači použite súbory snapshot: čítať ich smie akýkoľvek web.

Verzie

Toto je verzia 1 API a súborov snapshot. Iba pridávame: žiadna cesta, pole ani typ sa nemení ani nezmizne. Nekompatibilná zmena by prišla ako nová verzia vedľa tejto.

Použitie a uvedenie zdroja

API je zadarmo na akékoľvek použitie. Odkážte na EuroMakers tam, kde zobrazujete jeho údaje. Logá patria ich tvorcom a katalóg sa nesmie hromadne ďalej predávať.

Podmienky používania

Strojovo čitateľné