API

Svi proizvodi iz kataloga jednim zahtjevom:

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

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

• Datoteke snimke: besplatne, čitljive s bilo koje web-stranice, svake noći ponovno izrađene, bez ograničenja. Za preglednike i poslove s cijelim katalogom.
• API uživo: za vaš poslužitelj, oko 60 zahtjeva u minuti po IP adresi. Za jedan proizvod odjednom i svježije podatke.

Objavljeni katalog kao statične JSON datoteke, svake noći ponovno izrađene. Ponovno se zapisuju samo promijenjene datoteke i nijedna se ne broji u ograničenje.

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

S web-stranice:

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

Svaka krajnja točka na GET odgovara JSON-om. Primjeri odgovora su stvarni, ali skraćeni.

Svaki proizvod ima ova polja. Neobavezna se izostavljaju kad su prazna.

id · string

Stalan id, ujedno kraj adrese stranice proizvoda.

name · string

Naziv proizvoda.

description · string

Opis u jednoj rečenici.

audience · string[]

Kome je namijenjen: b2b, individual ili oboje.

country · string

Zemlja podrijetla.

website · uri

Web-stranica proizvoda.

longDescription · string

Nekoliko odlomaka o proizvodu.

features · string[]

Glavne značajke.

useCases · string[]

Od jednog do četiri id-a namjena.

category · string

Id kategorije, kao u /categories/{id}.

verified · boolean

neobavezno · true kad je tvorac potvrdio vlasništvo; inače ga nema.

logoUrl · uri

neobavezno · Logotip (PNG, JPEG ili WebP); nema ga ako logotipa nema.

Isto kao TypeScript tipovi:

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

Pogreške su JSON s porukom, stalnim kodom i savjetom:

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

60 zahtjeva u 60 sekundi po IP adresi, zajednički za sve krajnje točke, uključujući odgovore iz predmemorije. Iznad ograničenja dobivate 429 sa zaglavljima Retry-After (u sekundama) i X-RateLimit-Limit. Kad je API u cjelini jako opterećen, može odgovoriti 429 i prije nego što dosegnete svoje ograničenje.

Pošteno korištenje: ako vam treba više, koristite datoteke snimke.

Svaki odgovor nosi ETag. Pošaljite ga natrag u If-None-Match i nepromijenjen odgovor bit će 304 bez sadržaja.

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

API uživo ne šalje CORS zaglavlja, pa ga preglednik na drugoj stranici ne može pročitati. U pregledniku koristite datoteke snimke: može ih čitati bilo koja web-stranica.

Ovo je verzija 1 API-ja i datoteka snimke. Samo dodajemo: nijedna putanja, polje ni tip se ne mijenja niti nestaje. Nekompatibilna promjena došla bi kao nova verzija uz ovu.

API je besplatan za svaku upotrebu. Stavite poveznicu na EuroMakers ondje gdje prikazujete njegove podatke. Logotipi pripadaju svojim tvorcima, a katalog se ne smije preprodavati u cijelosti.

Uvjeti korištenja

• /openapi.json · OpenAPI 3.1 opis svake krajnje točke
• /llms.txt · Sažetak stranice za jezične modele
• https://data.euromakers.org/v1/manifest.json · Kad su datoteke nastale, koliko stavki ima svaka, njihova veličina i SHA-256 te uvjeti.