Aller au contenu

API

Interrogez la même base de domaines par programmation.

Authentification

Envoyez votre clé API comme jeton Bearer (ou dans l’en-tête X-API-Key). Créer une clé API

curl -H "Authorization: Bearer sk_…" \
  "https://namester.ai/api/v1/domains?view=auction&tld=com&maxPrice=100&sort=ends_at&order=asc"
  • Accès et limites de débit : l’API fait partie des offres Pro et Max. Le quota horaire de votre offre s’applique à l’ensemble de vos clés (Pro 25,000/heure, Max 100,000/heure), avec en plus une protection anti-rafale de 600 requêtes/minute par clé. Chaque réponse contient des en-têtes X-RateLimit-* pour la fenêtre horaire ; une réponse 429 inclut Retry-After. Les clés d’un compte Gratuit reçoivent 402 "API access requires a paid plan".
  • Vous utilisez Claude, Cursor ou un autre assistant IA ? Connectez la même clé au Serveur MCP
  • Les réponses sont en JSON avec les champs code, message et data ; code 0 signifie succès.
  • La pagination se fait par curseur : renvoyez nextCursor comme cursor jusqu’à ce qu’il soit null.
  • Les prix sont en USD, les heures en UTC (ISO 8601).
  • Spécification lisible par machine : /api/v1/openapi.json

GET/api/v1/domains

Lister les domaines. Mêmes filtres que la page /domains ; les filtres réservés aux offres payantes renvoient 403 sans offre payante.

Paramètres de requête
ParamètreTypeDescription
qstring
Mots-clés
Keywords; every token must appear in the label (name without the suffix).
anyOfstring (csv)
Contient l’un de
Comma-separated tokens; at least one must appear in the label.
excludestring (csv)
Exclure
Comma-separated tokens that must not appear in the label.
startsWithstring
Commence par
Label starts with this text.
endsWithstring
Se termine par
Label ends with this text.
viewall | auction | closeout | buy_now | make_offer | pre_release | pending_delete | deleted | registered
all = every domain with an active listing (best offer); a listing kind = one row per active listing of that kind; deleted / registered = registry drop events.
tldstring (csv)
Extensions
Comma-separated public suffixes, e.g. com,io,co.uk.
tldGrouplegacy_gtld | cctld | new_gtld | private (csv)
Groupe d’extensions
Comma-separated: legacy_gtld, cctld, new_gtld, private.
sourcenamecheap | godaddy | dynadot | sedo | dropcatch | gname | catched | czds | registry-se | registry-pl | registry-uk | registry-au (csv)
Source
Comma-separated data sources.
minPricenumber 0–1000000000
Prix min.
Minimum price in USD (best offer in view=all, the listing price otherwise).
maxPricenumber 0–1000000000
Prix max.
Maximum price in USD.
minLengthinteger 1–63
Longueur min.
Minimum label length (characters, IDN decoded).
maxLengthinteger 1–63
Longueur max.
Maximum label length.
noHyphenboolean
Sans tiret
Exclude labels with a hyphen.
noDigitboolean
Sans chiffre
Exclude labels with a digit.
onlyDigitsboolean
Chiffres uniquement
Only all-digit labels.
idnexclude | include | only
IDN
IDN handling: exclude, include (default) or only.
patternstring
Motif
Character pattern: C consonant, V vowel, N digit, H hyphen, L any letter. E.g. CVCV, LLLL.
minWordsinteger 1–3
Mots min.
Minimum dictionary words in the label (1–3).
maxWordsinteger 1–3
Mots max.
Maximum dictionary words in the label (1–3).
dictionaryboolean
Un seul mot du dictionnaire
Label is exactly one dictionary word.
endingWithininteger 1–720
Se termine dans
Ends within N hours.
minScoreinteger 0–100
Score min.
Minimum Namester Score (0–100).
maxScoreinteger 0–100
Score max.
Maximum Namester Score.
minAgeinteger 0–50
Ancienneté min. (années)
Minimum age in years.
minBidsinteger 0–10000
Enchères min.
Minimum bids (total across listings in view=all).
minBacklinksPayantinteger 0–1000000000
Backlinks min.
Minimum backlinks. Paid plans only (403 otherwise).
minDrPayantinteger 0–100
DR min.
Minimum Ahrefs DR. Paid plans only (403 otherwise).
minTfPayantinteger 0–100
TF min.
Minimum Majestic Trust Flow. Paid plans only (403 otherwise).
minCfPayantinteger 0–100
CF min.
Minimum Majestic Citation Flow. Paid plans only (403 otherwise).
minTrafficPayantinteger 0–1000000000
Trafic min.
Minimum estimated monthly traffic. Paid plans only (403 otherwise).
minTldsTakenPayantinteger 0–2000
Autres TLD min. (suivis)
Minimum number of other TLDs of the same label in our data (TLDs we track, not registry totals). Paid plans only (403 otherwise).
minSearchVolumePayantinteger 0–1000000000
Volume de recherche min.
Minimum monthly search volume reported by a supplier. Paid plans only (403 otherwise).
minBirthYearinteger 1985–2100
Année de création au plus tôt
Earliest registration year (where a source reports it).
maxBirthYearinteger 1985–2100
Année de création au plus tard
Latest registration year.
minWaybackYearinteger 1996–2100
Première année Wayback à partir de
Earliest first Wayback Machine capture year (only names with Wayback data).
maxWaybackYearinteger 1996–2100
Première année Wayback jusqu’à
Latest first Wayback capture year.
minWaybackAgeinteger 0–50
Ancienneté Wayback min. (années)
Minimum years since the first Wayback capture (only names with Wayback data).
daysinteger 1–90
Derniers
deleted / registered views: look-back window in days (default 7).
sortscore | price | ends_at | length | bids | name | age | first_seen
Sort field. Sorting by a field that can be empty (price, ends_at, age, bids) only returns rows where it is set. deleted / registered support first_seen (event date) and name.
orderasc | desc
asc or desc.
pageSize25 | 50 | 100 | 200
Rows per page: 25, 50, 100 or 200.
cursorstring
Opaque cursor from the previous response (nextCursor).

Réponse

{
  "code": 0,
  "message": "ok",
  "data": {
    "items": [{ "name": "…", "tld": "com", "score": 72, "kind": "auction",
                "source": "godaddy", "priceUsd": 45, "bids": 3,
                "endsAt": "2026-11-08T14:00:00.000Z", "listings": 2, … }],
    "nextCursor": "eyJzIjoic2NvcmUi…",
    "view": "auction", "sort": "ends_at", "order": "asc",
    "ignoredFilters": []
  }
}

Erreurs : 400 paramètres invalides · 401 clé manquante/invalide · 403 filtre payant · 404 domaine inconnu · 429 limite de débit atteinte.

GET/api/v1/domains/{name}

Profil de domaine : annonces actives de toutes les sources, détail du score, métriques SEO, historique des prix, ventes comparables, autres extensions et noms similaires.

GET/api/v1/stats

Totaux de l’inventaire par type d’annonce, source et événement de registre (mis en cache jusqu’à 5 minutes).