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ètre | Type | Description |
|---|---|---|
| q | string | Mots-clés Keywords; every token must appear in the label (name without the suffix). |
| anyOf | string (csv) | Contient l’un de Comma-separated tokens; at least one must appear in the label. |
| exclude | string (csv) | Exclure Comma-separated tokens that must not appear in the label. |
| startsWith | string | Commence par Label starts with this text. |
| endsWith | string | Se termine par Label ends with this text. |
| view | all | 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. |
| tld | string (csv) | Extensions Comma-separated public suffixes, e.g. com,io,co.uk. |
| tldGroup | legacy_gtld | cctld | new_gtld | private (csv) | Groupe d’extensions Comma-separated: legacy_gtld, cctld, new_gtld, private. |
| source | namecheap | godaddy | dynadot | sedo | dropcatch | gname | catched | czds | registry-se | registry-pl | registry-uk | registry-au (csv) | Source Comma-separated data sources. |
| minPrice | number 0–1000000000 | Prix min. Minimum price in USD (best offer in view=all, the listing price otherwise). |
| maxPrice | number 0–1000000000 | Prix max. Maximum price in USD. |
| minLength | integer 1–63 | Longueur min. Minimum label length (characters, IDN decoded). |
| maxLength | integer 1–63 | Longueur max. Maximum label length. |
| noHyphen | boolean | Sans tiret Exclude labels with a hyphen. |
| noDigit | boolean | Sans chiffre Exclude labels with a digit. |
| onlyDigits | boolean | Chiffres uniquement Only all-digit labels. |
| idn | exclude | include | only | IDN IDN handling: exclude, include (default) or only. |
| pattern | string | Motif Character pattern: C consonant, V vowel, N digit, H hyphen, L any letter. E.g. CVCV, LLLL. |
| minWords | integer 1–3 | Mots min. Minimum dictionary words in the label (1–3). |
| maxWords | integer 1–3 | Mots max. Maximum dictionary words in the label (1–3). |
| dictionary | boolean | Un seul mot du dictionnaire Label is exactly one dictionary word. |
| endingWithin | integer 1–720 | Se termine dans Ends within N hours. |
| minScore | integer 0–100 | Score min. Minimum Namester Score (0–100). |
| maxScore | integer 0–100 | Score max. Maximum Namester Score. |
| minAge | integer 0–50 | Ancienneté min. (années) Minimum age in years. |
| minBids | integer 0–10000 | Enchères min. Minimum bids (total across listings in view=all). |
| minBacklinksPayant | integer 0–1000000000 | Backlinks min. Minimum backlinks. Paid plans only (403 otherwise). |
| minDrPayant | integer 0–100 | DR min. Minimum Ahrefs DR. Paid plans only (403 otherwise). |
| minTfPayant | integer 0–100 | TF min. Minimum Majestic Trust Flow. Paid plans only (403 otherwise). |
| minCfPayant | integer 0–100 | CF min. Minimum Majestic Citation Flow. Paid plans only (403 otherwise). |
| minTrafficPayant | integer 0–1000000000 | Trafic min. Minimum estimated monthly traffic. Paid plans only (403 otherwise). |
| minTldsTakenPayant | integer 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). |
| minSearchVolumePayant | integer 0–1000000000 | Volume de recherche min. Minimum monthly search volume reported by a supplier. Paid plans only (403 otherwise). |
| minBirthYear | integer 1985–2100 | Année de création au plus tôt Earliest registration year (where a source reports it). |
| maxBirthYear | integer 1985–2100 | Année de création au plus tard Latest registration year. |
| minWaybackYear | integer 1996–2100 | Première année Wayback à partir de Earliest first Wayback Machine capture year (only names with Wayback data). |
| maxWaybackYear | integer 1996–2100 | Première année Wayback jusqu’à Latest first Wayback capture year. |
| minWaybackAge | integer 0–50 | Ancienneté Wayback min. (années) Minimum years since the first Wayback capture (only names with Wayback data). |
| days | integer 1–90 | Derniers deleted / registered views: look-back window in days (default 7). |
| sort | score | 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. |
| order | asc | desc | asc or desc. |
| pageSize | 25 | 50 | 100 | 200 | Rows per page: 25, 50, 100 or 200. |
| cursor | string | 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).