API

Όλα τα προϊόντα του καταλόγου, σε ένα αίτημα:

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

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

• Αρχεία στιγμιότυπου: δωρεάν, αναγνώσιμα από κάθε ιστότοπο, ξαναφτιάχνονται κάθε νύχτα, χωρίς όρια. Για browsers και εργασίες με όλο τον κατάλογο.
• Ζωντανό API: για τον server σας, περίπου 60 αιτήματα το λεπτό για κάθε διεύθυνση IP. Για ένα προϊόν τη φορά και πιο φρέσκα δεδομένα.

Ο δημοσιευμένος κατάλογος ως στατικά αρχεία JSON, που ξαναφτιάχνονται κάθε νύχτα. Ξαναγράφονται μόνο τα αρχεία που άλλαξαν, και κανένα δεν μετράει σε όριο.

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

Από μια ιστοσελίδα:

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

Κάθε endpoint απαντά σε GET με JSON. Οι απαντήσεις των παραδειγμάτων είναι πραγματικές αλλά συντομευμένες.

Κάθε προϊόν έχει αυτά τα πεδία. Τα προαιρετικά παραλείπονται όταν είναι κενά.

id · string

Σταθερό id, και το τέλος της διεύθυνσης της σελίδας του προϊόντος.

name · string

Όνομα προϊόντος.

description · string

Περιγραφή σε μία πρόταση.

audience · string[]

Για ποιους είναι: b2b, individual ή και τα δύο.

country · string

Χώρα προέλευσης.

website · uri

Ο ιστότοπος του προϊόντος.

longDescription · string

Λίγες παράγραφοι για το προϊόν.

features · string[]

Κύριες λειτουργίες.

useCases · string[]

Από ένα έως τέσσερα id χρήσεων.

category · string

Id κατηγορίας, όπως στο /categories/{id}.

verified · boolean

προαιρετικό · true όταν ο δημιουργός επιβεβαίωσε την ιδιοκτησία· αλλιώς λείπει.

logoUrl · uri

προαιρετικό · Λογότυπο (PNG, JPEG ή WebP)· λείπει όταν δεν υπάρχει.

Το ίδιο ως τύποι TypeScript:

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

Τα σφάλματα είναι JSON με μήνυμα, σταθερό κωδικό και υπόδειξη:

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

60 αιτήματα ανά 60 δευτερόλεπτα για κάθε διεύθυνση IP, κοινά για όλα τα endpoints, μαζί με τις απαντήσεις από την cache. Πάνω από το όριο παίρνετε 429 με τις κεφαλίδες Retry-After (σε δευτερόλεπτα) και X-RateLimit-Limit. Όταν το API συνολικά είναι πολύ φορτωμένο, μπορεί να απαντήσει 429 πριν φτάσετε το όριό σας.

Εύλογη χρήση: αν χρειάζεστε περισσότερα, χρησιμοποιήστε τα αρχεία στιγμιότυπου.

Κάθε απάντηση έχει ETag. Στείλτε το πίσω στο If-None-Match και μια απάντηση που δεν άλλαξε είναι 304 χωρίς σώμα.

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

Το ζωντανό API δεν στέλνει κεφαλίδες CORS, άρα ένας browser σε άλλον ιστότοπο δεν μπορεί να το διαβάσει. Σε browser, χρησιμοποιήστε τα αρχεία στιγμιότυπου: κάθε ιστότοπος μπορεί να τα διαβάσει.

Αυτή είναι η έκδοση 1 του API και των αρχείων στιγμιότυπου. Μόνο προσθέτουμε: καμία διαδρομή, πεδίο ή τύπος δεν αλλάζει ούτε χάνεται. Μια ασύμβατη αλλαγή θα ερχόταν ως νέα έκδοση δίπλα σε αυτή.

Το API είναι δωρεάν για κάθε χρήση. Βάλτε σύνδεσμο προς το EuroMakers όπου δείχνετε τα δεδομένα του. Τα λογότυπα ανήκουν στους δημιουργούς τους και ο κατάλογος δεν μεταπωλείται μαζικά.

Όροι χρήσης

• /openapi.json · Περιγραφή OpenAPI 3.1 κάθε endpoint
• /llms.txt · Σύνοψη του site για γλωσσικά μοντέλα
• https://data.euromakers.org/v1/manifest.json · Πότε φτιάχτηκαν τα αρχεία, πόσα στοιχεία έχει το καθένα, το μέγεθος και το SHA-256 τους, και οι όροι.