API
Consulta la misma base de datos de dominios de forma programática.
Autenticación
Envía tu clave de API como token Bearer (o en la cabecera X-API-Key). Crear una clave de API
curl -H "Authorization: Bearer sk_…" \ "https://namester.ai/api/v1/domains?view=auction&tld=com&maxPrice=100&sort=ends_at&order=asc"
- Acceso y límites de uso: la API forma parte de Pro y Max. La cuota por hora de tu plan se aplica a todas tus claves en conjunto (Pro 25,000/hora, Max 100,000/hora), además de un límite de ráfaga por clave de 600 solicitudes/minuto. Cada respuesta incluye cabeceras X-RateLimit-* para la ventana horaria; el 429 incluye Retry-After. Las claves de una cuenta Gratis reciben 402 "API access requires a paid plan".
- ¿Usas Claude, Cursor u otro asistente de IA? Conecta la misma clave al Servidor MCP
- Las respuestas son JSON con los campos code, message y data; code 0 significa éxito.
- La paginación es por keyset: devuelve nextCursor como cursor hasta que sea null.
- Los precios están en USD y las horas en UTC (ISO 8601).
- Especificación legible por máquina: /api/v1/openapi.json
GET/api/v1/domains
Lista dominios. Mismos filtros que la página /domains; los filtros de planes de pago devuelven 403 sin un plan de pago.
| Parámetro | Tipo | Descripción |
|---|---|---|
| q | string | Palabras clave Keywords; every token must appear in the label (name without the suffix). |
| anyOf | string (csv) | Contiene alguna de Comma-separated tokens; at least one must appear in the label. |
| exclude | string (csv) | Excluir Comma-separated tokens that must not appear in the label. |
| startsWith | string | Empieza por Label starts with this text. |
| endsWith | string | Termina en 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) | Extensiones Comma-separated public suffixes, e.g. com,io,co.uk. |
| tldGroup | legacy_gtld | cctld | new_gtld | private (csv) | Grupo de extensiones 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) | Fuente Comma-separated data sources. |
| minPrice | number 0–1000000000 | Precio mín. Minimum price in USD (best offer in view=all, the listing price otherwise). |
| maxPrice | number 0–1000000000 | Precio máx. Maximum price in USD. |
| minLength | integer 1–63 | Longitud mín. Minimum label length (characters, IDN decoded). |
| maxLength | integer 1–63 | Longitud máx. Maximum label length. |
| noHyphen | boolean | Sin guiones Exclude labels with a hyphen. |
| noDigit | boolean | Sin números Exclude labels with a digit. |
| onlyDigits | boolean | Solo números Only all-digit labels. |
| idn | exclude | include | only | IDN IDN handling: exclude, include (default) or only. |
| pattern | string | Patrón Character pattern: C consonant, V vowel, N digit, H hyphen, L any letter. E.g. CVCV, LLLL. |
| minWords | integer 1–3 | Palabras mín. Minimum dictionary words in the label (1–3). |
| maxWords | integer 1–3 | Palabras máx. Maximum dictionary words in the label (1–3). |
| dictionary | boolean | Una sola palabra de diccionario Label is exactly one dictionary word. |
| endingWithin | integer 1–720 | Termina en menos de Ends within N hours. |
| minScore | integer 0–100 | Puntuación mín. Minimum Namester Score (0–100). |
| maxScore | integer 0–100 | Puntuación máx. Maximum Namester Score. |
| minAge | integer 0–50 | Antigüedad mín. (años) Minimum age in years. |
| minBids | integer 0–10000 | Pujas mín. Minimum bids (total across listings in view=all). |
| minBacklinksDe pago | integer 0–1000000000 | Backlinks mín. Minimum backlinks. Paid plans only (403 otherwise). |
| minDrDe pago | integer 0–100 | DR mín. Minimum Ahrefs DR. Paid plans only (403 otherwise). |
| minTfDe pago | integer 0–100 | TF mín. Minimum Majestic Trust Flow. Paid plans only (403 otherwise). |
| minCfDe pago | integer 0–100 | CF mín. Minimum Majestic Citation Flow. Paid plans only (403 otherwise). |
| minTrafficDe pago | integer 0–1000000000 | Tráfico mín. Minimum estimated monthly traffic. Paid plans only (403 otherwise). |
| minTldsTakenDe pago | integer 0–2000 | Otros TLD mín. (seguidos) Minimum number of other TLDs of the same label in our data (TLDs we track, not registry totals). Paid plans only (403 otherwise). |
| minSearchVolumeDe pago | integer 0–1000000000 | Volumen de búsqueda mín. Minimum monthly search volume reported by a supplier. Paid plans only (403 otherwise). |
| minBirthYear | integer 1985–2100 | Año de creación más antiguo Earliest registration year (where a source reports it). |
| maxBirthYear | integer 1985–2100 | Año de creación más reciente Latest registration year. |
| minWaybackYear | integer 1996–2100 | Primer año en Wayback desde Earliest first Wayback Machine capture year (only names with Wayback data). |
| maxWaybackYear | integer 1996–2100 | Primer año en Wayback hasta Latest first Wayback capture year. |
| minWaybackAge | integer 0–50 | Antigüedad mín. en Wayback (años) Minimum years since the first Wayback capture (only names with Wayback data). |
| days | integer 1–90 | Últimos 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). |
Respuesta
{
"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": []
}
}Errores: 400 parámetros no válidos · 401 clave ausente o no válida · 403 filtro de pago · 404 dominio desconocido · 429 límite de uso superado.
GET/api/v1/domains/{name}
Perfil del dominio: publicaciones activas en todas las fuentes, desglose de la puntuación, métricas SEO, historial de precios, ventas comparables, otras extensiones y nombres similares.
GET/api/v1/stats
Totales del inventario por tipo de publicación, fuente y evento del registro (en caché hasta 5 minutos).