Namester API

Authentifizierung

Jede Anfrage braucht einen API-Schlüssel im Authorization-Header. Schlüssel erstellen und widerrufen Sie in Ihrem Dashboard. Wir speichern nur einen SHA-256-Hash jedes Schlüssels, daher wird der vollständige Schlüssel genau einmal angezeigt – beim Erstellen.

Authorization: Bearer nmst_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Setzen Sie einen Schlüssel nie in die URL. Anfragen mit einem dieser Query-Parameter werden mit 400 api_key_in_query abgelehnt statt beantwortet: api_key, apikey, api-key, key, token, access_token. URLs landen in Zugriffsprotokollen, Referrer-Headern und der Shell-Historie – ein Schlüssel, der in einer URL unterwegs war, gilt als offengelegt und sollte widerrufen werden.

Diese API sendet bewusst keine CORS-Header. Ein in Browser-JavaScript eingebetteter API-Schlüssel ist öffentlich. Rufen Sie die API von einem Server, einem geplanten Job oder einem Skript auf.

API-Schlüssel verwalten →

Ratenlimits

Kostenlose Konten: 20 Anfragen pro Stunde (bisher 60). Das Kontingent gehört weiterhin zum Konto und wird von allen seinen API-Schlüsseln geteilt; bezahlte Tarife bleiben unverändert.

Limits werden pro Konto gezählt: Alle API-Schlüssel Ihres Kontos teilen sich ein Stundenkontingent, weitere Schlüssel bringen also kein zusätzliches Kontingent. Ein außer Kontrolle geratenes Skript verbraucht daher auch das Kontingent Ihrer anderen Schlüssel; widerrufen Sie seinen Schlüssel, um es zu stoppen. Limits werden nicht pro IP-Adresse gezählt, damit Aufrufer hinter einer gemeinsamen Cloud-Egress-Adresse nicht zusammengeworfen werden.

Zeilen pro Stunde sind einfach das Anfragebudget mal die Seitenobergrenze von 200 Zeilen. Das kostenlose Budget soll für echte Auswahl- und Beobachtungsarbeit reichen, nicht zum Spiegeln des ganzen Index.

Antworten enthalten immer X-RateLimit-Limit, X-RateLimit-Window und X-RateLimit-Scope (immer "account": Die Zahlen beschreiben Ihr ganzes Konto, nicht den gesendeten Schlüssel) und zusätzlich X-RateLimit-Remaining und X-RateLimit-Reset (Unix-Sekunden), wann immer wir Ihre aktuelle Nutzung melden können. Nutzen Sie sie, um zurückzufahren, statt auf 429 zu testen.

Das Stundenkontingent wird pro Uhrstunde gezählt: Es beginnt zu jeder vollen Stunde (UTC) wieder bei null – das ist der Zeitpunkt in X-RateLimit-Reset. Über dem Budget erhalten Sie 429 mit einem Retry-After bis zu diesem Reset. Ist unser Ratenlimit-Backend selbst nicht verfügbar, antworten wir mit 503, statt die Anfrage ungezählt zu bedienen – ein ungezählter öffentlicher Endpunkt über einen Index mit Millionen Zeilen wäre der schlimmere Fehler.

Endpunkte

GET/api/v1/domains

Durchsucht den Index. Jeder Filter unten entspricht derselben Abfrage, die auch die Website nutzt; die Ergebnisse stimmen also mit der Weboberfläche bei gleichen Filtern überein (nur blendet die Webliste IDN-Namen standardmäßig aus). Die Ergebnisse werden per Keyset-Cursor seitenweise geliefert.

Ohne status wird nicht alles durchsucht. Ohne status liefert der Endpunkt nur laufende Auktionen, also status=auction, die noch nicht beendet sind – im Snapshot oben 2.087.217 von 2.920.052 indexierten Zeilen. Mit status=all durchsuchen Sie alle Zustände in einer Anfrage.

Jeder status-Wert, all eingeschlossen, enthält zusätzlich die Bedingung „noch nicht abgelaufen“: Ein Angebot, dessen Endzeit vorbei ist, wird nie geliefert. Das begrenzt jede Anfrage auf 2.594.318 Zeilen und macht 325.734 abgelaufene Zeilen unerreichbar. Angebote ganz ohne Endzeit, etwa Festpreis-Bestand, sind nicht betroffen.

curl -s \
  -H "Authorization: Bearer $NAMESTER_API_KEY" \
  "https://namester.ai/api/v1/domains?status=auction&tld=com&min_score=70&sort=namester_score&order=desc&limit=50"

{
  "object": "list",
  "data": [ { "domain_name": "…", "namester_score": 91, … } ],
  "pagination": {
    "page_size": 50,
    "page_index": 0,
    "next_cursor": "eyJ2Ijoi…",
    "has_more": true
  },
  "total": { "value": 11177, "accuracy": "exact" },
  "meta": { "api_version": "v1", "namester_score": "…" }
}

Die Gesamtzahl in dieser Antwort ist die echte Anzahl für genau diese Abfrage, status=auction mit tld=com und min_score=70, gemessen am 2026-09-09T15:35Z: 11.177 Zeilen. Sie ist nicht die Größe des Index, und sort, order und limit ändern sie nicht.

GET/api/v1/domains/{domain}

Fragt eine Domain nach Namen ab. Senden Sie die ASCII- oder Punycode-Form; der Name wird für Sie kleingeschrieben, sonst aber nicht verändert.

Ein Name, der derzeit auf keinem beobachteten Marktplatz angeboten wird, liefert 404 domain_not_found. Das ist eine echte Antwort, kein Fehler bei uns: Der Index enthält nur Namen, die gerade angeboten werden.

curl -s \
  -H "Authorization: Bearer $NAMESTER_API_KEY" \
  "https://namester.ai/api/v1/domains/example.com"

GET/api/v1/stats

Zählungen über den ganzen Index, damit Sie die Größe des Index nie aus einer gefilterten Suche ableiten müssen. Rufen Sie dies auf, bevor Sie entscheiden, wie Sie durch etwas blättern.

total zählt jede indexierte Zeile. live ist genau das, was der Such-Endpunkt ohne status liefert. retrievable ist die Obergrenze für status=all. by_status und by_source sind Zählungen über den ganzen Index, deren Schlüssel genau die Werte sind, die Sie an status (ohne all) und source übergeben dürfen. Die Zahlen werden fünf Minuten zwischengespeichert, und as_of sagt, wann der Stapel erhoben wurde.

Scheitert auch nur eine Zählung, ist die ganze Antwort 503 query_failed. Eine gescheiterte Zählung wird nie als null gemeldet: Steht sie einmal in Ihrem Parser, sehen eine Null und eine Messung, die wir nicht durchführen konnten, gleich aus – und Sie würden deswegen einen ganzen Marktplatz aus Ihrer Abfrageliste streichen.

curl -s \
  -H "Authorization: Bearer $NAMESTER_API_KEY" \
  "https://namester.ai/api/v1/stats"

{
  "object": "stats",
  "data": {
    "as_of": "2026-09-09T15:35:02.896Z",
    "total": 2920052,
    "live": 2087217,
    "retrievable": 2594318,
    "by_status": {
      "auction": 2344608,
      "dropping": 118359,
      "available": 457085
    },
    "by_source": {
      "namecheap": 1303218,
      "godaddy": 1083827,
      "dynadot": 495835,
      "dropcatch": 22877,
      "sedo": 14295
    }
  },
  "meta": { "api_version": "v1", "namester_score": "…", "counts": "…" }
}

Query-Parameter

Alle Parameter sind optional und gelten nur für den Such-Endpunkt. Der Abfrage-Endpunkt akzeptiert keine.

• Ein unbekannter Parameter ist ein 400, kein stilles Nichts. Ein Tippfehler wie min_scores würde Ihnen sonst die erste Seite des ganzen Index liefern, während Sie glauben, sie sei gefiltert.
• Ein wiederholter Parameter ist ein 400. Nur den ersten Wert zu behalten und den Rest zu verwerfen, sähe so aus, als hätte es funktioniert.
• Ein leerer Wert wird behandelt, als fehle der Parameter – tld= verhält sich also genau wie ein weggelassenes tld.
• tld und source werden vor der Verwendung kleingeschrieben. Sie werden auf exakte Gleichheit mit kleingeschriebenen Werten in der Datenbank verglichen – tld=COM wäre sonst eine völlig gültige Anfrage, die rein gar nichts findet.
• limit akzeptiert eine ganze Zahl von 1 bis 200. Alles unter 10 wird auf 10 angehoben, die Untergrenze der darunterliegenden Abfrageschicht. Der Standard ist 50. Der tatsächlich angewendete Wert kommt immer als pagination.page_size zurück.

Sortierbare Felder: domain_name, length, current_bid, auction_end_time, bid_count, buy_now_price, namester_score. Unsortierte Anfragen sortieren nach namester_score absteigend, außer status=dropping, das nach kürzestem Namen zuerst sortiert.

Seitenweise Abfrage

Die Paginierung basiert auf Keysets, nicht auf Offsets: Jede Seite liefert einen undurchsichtigen next_cursor, den Sie unverändert zurückgeben, um die nächste Seite zu erhalten. Einen offset- oder page-Parameter gibt es mit Absicht nicht. Offset-Paginierung über Millionen Zeilen wird mit jeder Seite langsamer und überspringt oder wiederholt Zeilen, sobald sich die Daten zwischen Anfragen ändern – bei einem Feed laufender Auktionen also ständig.

Lesen Sie has_more oder prüfen Sie, ob next_cursor null ist. Schließen Sie nicht aus einer vollen Seite auf das Ende der Ergebnisse: Eine volle Seite bedeutet genau das, nicht, dass Sie am Ende sind.

Ein Cursor kodiert die Filter, die Sortierung und das Limit, mit denen er erstellt wurde, und ist signiert. Ändern Sie eines davon oder den Cursor selbst, wird der Cursor als veraltet abgelehnt, und Sie erhalten die erste Seite der neuen Ergebnismenge statt einer Seite der alten.

# 翻页:把上一页返回的 pagination.next_cursor 原样传回来
curl -s \
  -H "Authorization: Bearer $NAMESTER_API_KEY" \
  "https://namester.ai/api/v1/domains?status=auction&tld=com&limit=50&cursor=$CURSOR"

total.value ist die Anzahl passender Zeilen, und total.accuracy sagt, wie sie ermittelt wurde: exact ist eine echte Zählung. at_least bedeutet, der Wert ist eine Untergrenze (die echte Zahl ist mindestens so hoch). Das kommt in drei Fällen vor: bei einer Suche mit einem Begriff unter 3 Zeichen oder einem Filter min_price / max_price – diese Zählungen stoppen nach 100 Treffern, weil eine exakte Zählung nicht in das Zeitbudget passt (100 oder weniger Treffer werden exakt gezählt und als exact gemeldet); bei jeder Abfrage mit Suchbegriff oder Preisfilter, deren Zählung nicht rechtzeitig fertig wurde – dann ist der Wert die Anzahl der Zeilen auf dieser Seite; und selten, wenn die Zählung kleiner ausfiel als die tatsächlich gelieferten Zeilen. planned ist die Schätzung des Query-Planers, nur für Abfragen ohne Suchbegriff und ohne Preisfilter, als Rückfall, wenn die exakte Zählung ihr Zeitbudget überschreitet. Eine planned-Gesamtzahl kann weit danebenliegen und sollte nicht als genaue Zahl angezeigt werden.

Antwortfelder

Beide Endpunkte liefern dasselbe Domain-Objekt mit diesem festen Feldsatz:

Felder, für die wir keinen Wert haben, kommen als null statt weggelassen, damit jedes Objekt dieselbe Form hat. Interne Spalten werden nie geliefert – deshalb können wir Spalten ergänzen, ohne Ihren Parser zu brechen.

Über namester_score

namester_score bewertet Nachfrage und Liquidität auf einer Skala von 0 bis 100: wie umkämpft ein Name ist und wie wahrscheinlich er einen Käufer findet. Berechnet wird er aus Länge, Zeichenzusammensetzung, öffentlicher Endung, Domain-Alter, Marktplatzaktivität und den Autoritätskennzahlen, die wir zu diesem Namen haben.

Er ist kein Preis, kein Gutachten und keine Bewertung und darf nicht als solche verwendet werden. Das separate Feld valuation ist eine Schätzung des Marktplatzes und hat mit diesem Score nichts zu tun. Jede erfolgreiche Antwort wiederholt das in meta.namester_score, damit der Hinweis mit den Daten mitreist.

Der höchste Score im Index war am 2026-09-09 98. Die Skala ist von 0 bis 100 definiert, aber das obere Ende hängt davon ab, wie viele Autoritätsdaten wir anreichern konnten – Schwellen nahe 100 können daher berechtigterweise nichts liefern.

Fehler

Fehler haben immer dieselbe Hülle und enthalten nie Datenbankmeldungen, SQL-Fragmente oder Stacktraces. 4xx heißt, die Anfrage muss sich ändern; 5xx heißt, das Problem liegt bei uns und ein erneuter Versuch lohnt sich.

Ein Fehler wird nie als leeres Ergebnis getarnt. Wird eine Abfrage nicht abgeschlossen, erhalten Sie 503 query_failed – nie HTTP 200 mit einem leeren Array. Für Ihren Code bedeuten diese beiden das Gegenteil: Das eine sollte wiederholt werden, das andere heißt, Sie sollten Ihre Filter erweitern. Eine Suche, die läuft und nichts findet, liefert 200 mit leerem data-Array und einer Gesamtzahl von null.

{
  "error": {
    "code": "invalid_parameter",
    "message": "\"min_score\" must be <= 100, got 140.",
    "param": "min_score"
  }
}

Jede 5xx-Antwort trägt Retry-After, und 429 trägt einen Wert, der aus dem echten Reset des Ratenlimit-Fensters berechnet ist. Halten Sie sich daran.

MCP-Server

Ein kleiner, schreibgeschützter MCP-Server lässt einen KI-Assistenten diese API für Sie abfragen. Er läuft auf Ihrem eigenen Rechner: Ihr MCP-Client startet ihn als lokalen Prozess und spricht über stdio mit ihm. Es gibt keinen gehosteten MCP-Endpunkt und keine URL zum Einfügen. Jeder Tool-Aufruf ist eine normale Anfrage an diese API mit Ihrem Schlüssel und zählt daher gegen das Stundenlimit Ihres Kontos, das sich alle Schlüssel des Kontos teilen.

Tools

• search_domains — den Index durchsuchen, mit den Parameternamen des Listen-Endpunkts (die selten befüllten SEO-Filter – DR, TF, Backlinks, Suchvolumen – sind nicht dabei, und min_extensions funktioniert nur mit dem Schlüssel eines bezahlten Tarifs)
• get_domain — eine einzelne Domain nach Namen abfragen
• market_stats — Indexgröße nach Status und nach Quelle

Keines der Tools bietet, bearbeitet eine Merkliste oder ändert sonst etwas – der Server liest nur.

Einrichten

1. Erstellen Sie in Ihrem Dashboard einen API-Schlüssel. Ein kostenloses Konto genügt. API-Schlüssel verwalten →
2. Laden Sie den Server herunter. Er ist eine einzelne Datei ohne Abhängigkeiten und braucht Node.js 18 oder neuer. namester-mcp.mjs

   curl -fsSLo namester-mcp.mjs https://namester.ai/mcp/namester-mcp.mjs
   sha256sum namester-mcp.mjs   # macOS: shasum -a 256 namester-mcp.mjs

   SHA-256 der aktuellen Datei (33.341 Bytes): 3852d5868a767909f41654a3f18754caf2b29534bfa4a0e4ea6cff9e3c0cb2ba

3. Fügen Sie ihn der Konfiguration Ihres MCP-Clients hinzu – etwa claude_desktop_config.json für Claude Desktop oder .cursor/mcp.json für Cursor. Verwenden Sie den absoluten Pfad der heruntergeladenen Datei:

   {
     "mcpServers": {
       "namester": {
         "command": "node",
         "args": ["/absolute/path/to/namester-mcp.mjs"],
         "env": {
           "NAMESTER_API_KEY": "nmst_live_…"
         }
       }
     }
   }

   Oder mit Claude Code:

   claude mcp add namester -e NAMESTER_API_KEY=nmst_live_… -- node /absolute/path/to/namester-mcp.mjs

Der Schlüssel steht im Klartext in dieser Konfigurationsdatei. Behandeln Sie die Datei wie ein Passwort und widerrufen Sie den Schlüssel in Ihrem Dashboard, falls sie in falsche Hände gerät.

Die Tool-Beschreibungen und Ergebnistexte sind derzeit auf Chinesisch.

Ihr eigenes KI-Modell mit Namester nutzen

Verbinden Sie den MCP-Server oben mit einer KI-App, die Sie bereits nutzen, und fragen Sie dann in Alltagssprache. Das Modell läuft in dieser App und wird über Ihr eigenes KI-Abo oder Ihre API-Rechnung bezahlt; Namester betreibt es nicht und berechnet nichts dafür. Jeder Tool-Aufruf des Modells ist eine Anfrage an diese API mit Ihrem Schlüssel und wird daher auf das Stundenkontingent Ihres Kontos angerechnet: 20 Anfragen pro Stunde mit einem kostenlosen Konto und 25.000 mit Pro, gemeinsam genutzt von allen Schlüsseln des Kontos.

Die Prompts unten funktionieren in KI-Apps, die einen lokalen MCP-Server starten können, etwa Claude Desktop, Claude Code und Cursor. Eine App, die nur gehostete (Remote-)MCP-Server akzeptiert, kann diesen nicht nutzen, weil er auf Ihrem eigenen Rechner läuft.

Kopieren Sie einen Prompt, passen Sie die Details an und fügen Sie ihn in Ihre KI-App ein.

Finden Sie mit den Namester-Tools .com-Auktionen, die innerhalb der nächsten 24 Stunden enden, mit Namen aus höchstens 6 Zeichen, ohne Bindestriche oder Ziffern und mit einem Namester Score von mindestens 60. Zeigen Sie die 20 mit den meisten Geboten als Tabelle: Domain, aktuelles Gebot, Anzahl der Gebote, Endzeit in UTC und Marktplatz. Schätzen Sie bei keiner davon, was sie wert ist.

Nutzen Sie für jede Domain unten das Namester-Tool get_domain und sagen Sie mir, ob sie gerade angeboten wird, auf welchem Marktplatz, mit welchem Status und Preis, wie viele Gebote sie hat und wann sie endet. Steht ein Name nicht im Index, schreiben Sie „nicht angeboten“, statt zu raten.

brightlane.com
novahive.io
quickparcel.co

Rufen Sie das Namester-Tool market_stats auf und fassen Sie zusammen, wie viele laufende Angebote es gibt, nach Status und nach Marktplatz. Suchen Sie dann nach .ai- und .io-Namen mit 5 Buchstaben und einem Preis von höchstens 100 $, und listen Sie die 15 mit dem höchsten Namester Score mit Preis und Endzeit auf.

Schlagen Sie 15 kurze, markenfähige .com-Namen für ein Abo mit Spezialitätenkaffee vor. Prüfen Sie dann mit den Such-Tools von Namester, welche davon gerade angeboten werden, und zeigen Sie nur diese, mit Preis, Status und Marktplatz. Sagen Sie deutlich, dass ein Name, der nicht angeboten wird, trotzdem schon von jemandem registriert sein kann.

Was im Index steht

Exakte Zählungen aus dem Snapshot vom 2026-09-09T15:35Z. Der Index enthält Namen, die gerade auf einem der Marktplätze unten angeboten werden; Namen, die nicht mehr angeboten werden, verschwinden innerhalb weniger Tage.

Diese Seite ist ein Snapshot. GET /api/v1/stats berechnet dieselben Zahlen auf Abruf und ist immer die aktuellere Quelle – lesen Sie sie also dort, statt uns diese Seite zu zitieren.

• Nach Status: 2.344.608 auction, 118.359 dropping, 457.085 available.
• Nur 50.016 der 118.359 dropping-Zeilen hatten zum Messzeitpunkt einen Löschzeitpunkt in der Zukunft. Dropping-Angebote laufen in täglichen Stapeln ab, daher schrumpft dieser Ausschnitt zu bestimmten Stunden berechtigterweise auf fast nichts. Das sind die Daten, kein Ausfall.
• tld enthält die vollständige öffentliche Endung, daher haben 13.020 Zeilen eine Endung mit Punkt, zum Beispiel co.uk mit 1.986 Zeilen. Fragen Sie die ganze Endung ab, nicht das letzte Label.
• 2.333.471 von 2.920.052 Zeilen haben einen Preis bei null Geboten. Das ist ein Start- oder Wunschpreis, kein Gebot. Lesen Sie bid_count immer neben current_bid, bevor Sie eine Zahl als Beleg für Konkurrenz nehmen.
• Jeder Marktplatz wird nach eigenem Plan neu abgerufen, von stündlich bis einmal täglich. last_checked_at sagt, wann wir dieses Angebot zuletzt gesehen haben, updated_at, wann sich seine Zeile zuletzt geändert hat.
• In diesem Snapshot ergeben die drei Status-Zählungen und die fünf Quellen-Zählungen jeweils genau 2.920.052 – daran sehen wir, dass er nicht mitten in einer Neusynchronisierung erhoben wurde. Verlassen Sie sich nicht darauf: Die Zählungen laufen parallel gegen eine Tabelle, die die Sync-Jobs ständig neu schreiben, und ein früherer Versuch am selben Nachmittag fiel in einen Stapelwechsel und ging nicht auf.