REST · JSON · v1

La API de losdominios.es

Para resellers que quieren vender dominios en su web y para domainers que gestionan su cartera desde sus propias herramientas.

Autenticación

Envía tu clave en la cabecera X-Api-Key (o Authorization: Bearer). La tienes en tu panel. Límite: 600 peticiones por minuto. Importes de registro en céntimos sin IVA; precios del mercado en euros sin IVA.

curl -H "X-Api-Key: ld_tu_clave" \ "https://losdominios.es/api/v1/check?domain=tumarca.es"

Crea una cuenta gratis para obtener tu clave.

Errores

  • 401 falta la clave o no es válida
  • 404 el dominio no está en el mercado
  • 422 datos no válidos (el cuerpo trae error)
  • 429 demasiadas peticiones

Endpoints

GET/api/v1/check?domain=tumarca.es

Disponibilidad y precio de registro por año (con tu margen si eres reseller).

{"ok":true,"domain":"tumarca.es","status":"available","price":1249,"currency":"EUR","per":"year","vat_included":false}
GET/api/v1/tlds

Extensiones con precio de registro y renovación.

{"ok":true,"tlds":[{"tld":"es","register":999,"renew":999}]}
GET/api/v1/listings?q=boda&tema=bodas&tld=es&modo=alquilar&p=1

Dominios del mercado con filtros (mismos que la web).

{"ok":true,"total":14,"page":1,"pages":1,"listings":[{"domain":"cancionesdeboda.com","price":9800,"rent_monthly":157,"url":"…"}]}
GET/api/v1/listings?domain=cancionesdeboda.com

Ficha completa de un dominio del mercado.

{"ok":true,"listing":{"domain":"cancionesdeboda.com","headline":"…","advantages":["…"],"ideas":["…"],"video":"…"}}
POST/api/v1/offers

Envía una oferta en nombre de un comprador. Cuerpo JSON: domain, amount, email, name, message.

{"ok":true,"offer":{"status":"pending","url":"…/oferta/…"}}
GET/api/v1/portfolio

Tu cartera: tus dominios con estado, precios, visitas y ofertas.

{"ok":true,"listings":[{"domain":"…","status":"active","views":120,"offers":2}]}
POST/api/v1/portfolio

Crea o actualiza dominios de tu cartera. Cuerpo JSON: {"listings":[{"domain":"…","price":2400,"min_offer":1200,"rent_monthly":39}]}

{"ok":true,"created":1,"updated":0,"errors":[]}