API

Bezplatné JSON API jen pro čtení, pro zveřejněný katalog. Bez klíče.

Rychlý start

Všechny produkty z katalogu jedním požadavkem:

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

Které použít?

  • Soubory snapshot: zdarma, čitelné z jakéhokoli webu, každou noc znovu sestavené, bez limitů. Pro prohlížeče a úlohy s celým katalogem.
  • Živé API: pro váš server, asi 60 požadavků za minutu na IP adresu. Pro jeden produkt naráz a čerstvější data.

Soubory snapshot

Zveřejněný katalog jako statické soubory JSON, každou noc znovu sestavené. Přepisují se jen změněné soubory a žádný se nepočítá do limitu.

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

Pole produktů seřazené podle id kategorie a pak podle id. Stejný JSON jako 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ázvů zemí, každý jednou, v pořadí katalogu (neseřazené). Stejný JSON jako GET /api/software/countries.

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

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

Objekt z id kategorie na počet produktů. Kategorie bez produktů chybí. Stejný JSON jako GET /api/categories/counts.

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

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

Známé nástroje, každý s ID produktů pro stejnou práci, jako na stránkách nástrojů.

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

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

Kdy soubory vznikly, kolik položek každý obsahuje, jejich velikost a SHA-256 a podmínky.

{
  "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 webové stránky:

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

Endpointy

Každý endpoint odpovídá na GET ve formátu JSON. Ukázkové odpovědi jsou skutečné, ale zkrácené.

GET /api/software

Pole produktů seřazené podle id kategorie a pak podle id.

Parametry

Žádné

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

429 · 500 · 503

Cache

Uchováno na okraji sítě až 24 hodin a vymazáno, když se katalog změní. s-maxage=86400

GET /api/software/{id}

Jeden produkt. Neznámé nebo nezveřejněné id vrátí 404.

Parametry
  • id · string · path · povinnýId produktu: malá písmena, číslice a pomlčky. ^[a-z0-9-]{1,80}$
Příklad
curl https://www.euromakers.org/api/software/proton-mail
Odpověď
{
  "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

Uchováno na okraji sítě až 24 hodin a vymazáno, když se katalog změní. s-maxage=86400

GET /api/software/countries

Pole názvů zemí, každý jednou, v pořadí katalogu (neseřazené).

Parametry

Žádné

Příklad
curl https://www.euromakers.org/api/software/countries
Odpověď
["Germany", "France", "Slovakia", "…"]
Chyby

429 · 500 · 503

Cache

Uchováno na okraji sítě až 24 hodin a vymazáno, když se katalog změní. s-maxage=86400

GET /api/categories/counts

Objekt z id kategorie na počet produktů. Kategorie bez produktů chybí.

Parametry

Žádné

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

429 · 500 · 503

Cache

Uchováno na okraji sítě až 24 hodin a vymazáno, když se katalog změní. s-maxage=86400

Produkt

Každý produkt má tato pole. Volitelná se vynechávají, když jsou prázdná.

id · string
Stálé id, zároveň konec adresy stránky produktu.
name · string
Název produktu.
description · string
Popis v jedné větě.
audience · string[]
Pro koho je: b2b, individual nebo obojí.
country · string
Země původu.
website · uri
Web produktu.
longDescription · string
Pár odstavců o produktu.
features · string[]
Hlavní funkce.
useCases · string[]
Jedno až čtyři id případů použití.
category · string
Id kategorie, jako v /categories/{id}.
verified · boolean
volitelné · true, když tvůrce ověřil vlastnictví; jinak chybí.
logoUrl · uri
volitelné · Logo (PNG, JPEG nebo WebP); chybí, pokud žádné není.

Totéž jako 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 jsou JSON se zprávou, stálým kódem a nápovědou:

{
  "code": "not_found",
  "error": "Software not found",
  "hint": "List known ids with GET /api/software, then retry with an existing kebab-case id."
}
StavKódKdy
404not_foundNeznámé id, nebo na této cestě není žádný endpoint.
429rate_limitedPřekročen limit požadavků.
500internal_errorNěco se pokazilo na naší straně.
503catalog_unavailableKatalog se nepodařilo načíst.

Limity požadavků

60 požadavků za 60 sekund na IP adresu, společně pro všechny endpointy, včetně odpovědí z cache. Nad limitem dostanete 429 s hlavičkami Retry-After (v sekundách) a X-RateLimit-Limit. Když je API jako celek hodně vytížené, může odpovědět 429 dřív, než dosáhnete svého limitu.

Férové používání: pokud potřebujete víc, použijte soubory snapshot.

Podmíněné požadavky

Každá odpověď nese ETag. Pošlete ho zpět v If-None-Match a nezměněná odpověď 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 neposílá hlavičky CORS, takže prohlížeč na jiném webu ho nepřečte. V prohlížeči použijte soubory snapshot: číst je smí jakýkoli web.

Verze

Toto je verze 1 API a souborů snapshot. Pouze přidáváme: žádná cesta, pole ani typ se nemění ani nezmizí. Nekompatibilní změna by přišla jako nová verze vedle této.

Použití a uvedení zdroje

API je zdarma pro jakékoli použití. Odkažte na EuroMakers tam, kde zobrazujete jeho data. Loga patří svým tvůrcům a katalog se nesmí hromadně přeprodávat.

Podmínky použití

Strojově čitelné