Saltar al contenido

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ámetros de consulta
ParámetroTipoDescripción
qstring
Palabras clave
Keywords; every token must appear in the label (name without the suffix).
anyOfstring (csv)
Contiene alguna de
Comma-separated tokens; at least one must appear in the label.
excludestring (csv)
Excluir
Comma-separated tokens that must not appear in the label.
startsWithstring
Empieza por
Label starts with this text.
endsWithstring
Termina en
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)
Extensiones
Comma-separated public suffixes, e.g. com,io,co.uk.
tldGrouplegacy_gtld | cctld | new_gtld | private (csv)
Grupo de extensiones
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)
Fuente
Comma-separated data sources.
minPricenumber 0–1000000000
Precio mín.
Minimum price in USD (best offer in view=all, the listing price otherwise).
maxPricenumber 0–1000000000
Precio máx.
Maximum price in USD.
minLengthinteger 1–63
Longitud mín.
Minimum label length (characters, IDN decoded).
maxLengthinteger 1–63
Longitud máx.
Maximum label length.
noHyphenboolean
Sin guiones
Exclude labels with a hyphen.
noDigitboolean
Sin números
Exclude labels with a digit.
onlyDigitsboolean
Solo números
Only all-digit labels.
idnexclude | include | only
IDN
IDN handling: exclude, include (default) or only.
patternstring
Patrón
Character pattern: C consonant, V vowel, N digit, H hyphen, L any letter. E.g. CVCV, LLLL.
minWordsinteger 1–3
Palabras mín.
Minimum dictionary words in the label (1–3).
maxWordsinteger 1–3
Palabras máx.
Maximum dictionary words in the label (1–3).
dictionaryboolean
Una sola palabra de diccionario
Label is exactly one dictionary word.
endingWithininteger 1–720
Termina en menos de
Ends within N hours.
minScoreinteger 0–100
Puntuación mín.
Minimum Namester Score (0–100).
maxScoreinteger 0–100
Puntuación máx.
Maximum Namester Score.
minAgeinteger 0–50
Antigüedad mín. (años)
Minimum age in years.
minBidsinteger 0–10000
Pujas mín.
Minimum bids (total across listings in view=all).
minBacklinksDe pagointeger 0–1000000000
Backlinks mín.
Minimum backlinks. Paid plans only (403 otherwise).
minDrDe pagointeger 0–100
DR mín.
Minimum Ahrefs DR. Paid plans only (403 otherwise).
minTfDe pagointeger 0–100
TF mín.
Minimum Majestic Trust Flow. Paid plans only (403 otherwise).
minCfDe pagointeger 0–100
CF mín.
Minimum Majestic Citation Flow. Paid plans only (403 otherwise).
minTrafficDe pagointeger 0–1000000000
Tráfico mín.
Minimum estimated monthly traffic. Paid plans only (403 otherwise).
minTldsTakenDe pagointeger 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 pagointeger 0–1000000000
Volumen de búsqueda mín.
Minimum monthly search volume reported by a supplier. Paid plans only (403 otherwise).
minBirthYearinteger 1985–2100
Año de creación más antiguo
Earliest registration year (where a source reports it).
maxBirthYearinteger 1985–2100
Año de creación más reciente
Latest registration year.
minWaybackYearinteger 1996–2100
Primer año en Wayback desde
Earliest first Wayback Machine capture year (only names with Wayback data).
maxWaybackYearinteger 1996–2100
Primer año en Wayback hasta
Latest first Wayback capture year.
minWaybackAgeinteger 0–50
Antigüedad mín. en Wayback (años)
Minimum years since the first Wayback capture (only names with Wayback data).
daysinteger 1–90
Últimos
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).

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).