API de datos de países y subdivisiones
para formularios y validación
Ver cómo funciona
Características
<!-- Include the widget script with your public key -->
<script src="https://unpkg.com/@countriesdb/widget@latest/dist/index.js?public_key=YOUR_PUBLIC_KEY"></script>
<!-- Country select with data-name -->
<select class="country-selection" data-name="country1"></select>
<!-- Subdivision select linked to country -->
<select class="subdivision-selection" data-country="country1"></select>Conéctalo y listo en tu formulario
Agrega atributos HTML simples y verás cómo los campos select se autocompletan con datos de países y subdivisiones en el idioma del usuario automáticamente.

Geolocalización incluida
Detecta y preselecciona automáticamente el país y la subdivisión del usuario según su dirección IP. No se requiere configuración: funciona de fábrica.

Compatibilidad multilingüe
Muestra automáticamente los nombres de países y subdivisiones en el idioma del navegador del usuario. Ofrece soporte para más de 50 idiomas con una cobertura de traducción integral para una integración global sin fisuras.

Coherencia de datos crítica
Datos conformes a la norma ISO 3166, siempre actualizados y fiables. Perfectos para aplicaciones críticas que requieren información precisa de países y subdivisiones con una consistencia garantizada.
// Backend fetch (keep your private token server-side)
const res = await fetch("https://api.countriesdb.com/api/data/countries", {
headers: {
Authorization: `Bearer ${process.env.COUNTRIESDB_PRIVATE_TOKEN}`,
Accept: "application/json",
"Accept-Language": "en",
},
});
const countries = await res.json();API de backend para integraciones personalizadas
¿Prefieres obtener los datos desde el servidor? Usa la API de datos de backend autenticada con Bearer para países y subdivisiones. Ver documentación completa.
¿Por qué los desarrolladores eligen CountriesDB?
Bibliotecas para frameworks
Integración perfecta sin complicaciones
Integración sencilla con React, Angular, Vue, Python, Java y más.
API flexible
Diseñada para tus necesidades
API de validación para entradas de formulario consistentes, además de una API de datos de backend para listar países y subdivisiones desde el servidor.
Traducciones globales
Pretraducido para uso mundial
Soporta los idiomas más populares para una integración global sin fisuras.
Siempre actualizado
Datos precisos y fiables
Mantente al día con los últimos datos de países y subdivisiones, actualizados periódicamente.
Compatible con todas las plataformas web, frameworks e idiomas
Instalación
<!-- Include the widget script with your public key -->
<script src="https://unpkg.com/@countriesdb/widget@latest/dist/index.js?public_key=YOUR_PUBLIC_KEY"></script>Uso
<!-- Country select with data-name -->
<select class="country-selection" data-name="country1"></select>
<!-- Subdivision select linked to country -->
<select class="subdivision-selection" data-country="country1"></select>¿Necesitas ayuda con la integración?
Podemos integrar los Widgets de CountriesDB en tu sitio o aplicación sin costo si estás en el plan de pago.
La mayoría de los equipos usan nuestras guías de widgets y documentación de frameworks por su cuenta. Si prefieres que nos encarguemos nosotros, escríbenos a través del formulario de contacto a continuación.



