Primeros pasos
Aprende a realizar tu primera consulta a la RAE API en minutos
URL base
Todas las consultas a la API deben dirigirse a:
https://rae-api.comTu primera consulta
La forma más sencilla de probar la API es buscar una palabra específica. Aquí tienes un ejemplo usando cURL:
curl https://rae-api.com/api/words/amarRespuesta esperada
La API devolverá un objeto JSON con la siguiente estructura completa:
Respuesta de /api/words/amar
{
"data": {
"word": "amar",
"meanings": [
{
"origin": {
"raw": "Del lat. amāre.",
"type": "lat",
"voice": "",
"text": "amāre"
},
"senses": [
{
"raw": "1. tr. Tener amor a alguien o algo.Sin.:querer1, adorar, idolatrar, estimar, apreciar, camelar.Ant.:odiar, abominar, aborrecer, detestar, desamar.",
"meaning_number": 1,
"category": "verb",
"verb_category": "transitive",
"usage": "",
"description": "Tener amor a alguien o algo",
"synonyms": [
"querer",
"adorar",
"idolatrar",
"estimar",
"apreciar",
"camelar"
],
"antonyms": [
"odiar",
"abominar",
"aborrecer",
"detestar",
"desamar"
]
},
{
"raw": "2. tr. p. us. desear.",
"meaning_number": 2,
"category": "verb",
"verb_category": "transitive",
"usage": "rare",
"description": "desear",
"synonyms": null,
"antonyms": null
}
],
"conjugations": {
"non_personal": {
"infinitive": "amar",
"participle": "amado",
"gerund": "amando",
"compound_infinitive": "haber amado",
"compound_gerund": "habiendo amado"
},
"indicative": {
"present": {
"singular_first_person": "amo",
"singular_second_person": "amas / amás",
"singular_formal_second_person": "ama",
"singular_third_person": "ama",
"plural_first_person": "amamos",
"plural_second_person": "amáis",
"plural_formal_second_person": "aman",
"plural_third_person": "aman"
},
"present_perfect": {
"singular_first_person": "he amado",
"singular_second_person": "has amado",
"singular_formal_second_person": "ha amado",
"singular_third_person": "ha amado",
"plural_first_person": "hemos amado",
"plural_second_person": "habéis amado",
"plural_formal_second_person": "han amado",
"plural_third_person": "han amado"
},
"imperfect": {
"singular_first_person": "amaba",
"singular_second_person": "amabas",
"singular_formal_second_person": "amaba",
"singular_third_person": "amaba",
"plural_first_person": "amábamos",
"plural_second_person": "amabais",
"plural_formal_second_person": "amaban",
"plural_third_person": "amaban"
},
"past_perfect": {
"singular_first_person": "había amado",
"singular_second_person": "habías amado",
"singular_formal_second_person": "había amado",
"singular_third_person": "había amado",
"plural_first_person": "habíamos amado",
"plural_second_person": "habíais amado",
"plural_formal_second_person": "habían amado",
"plural_third_person": "habían amado"
},
"preterite": {
"singular_first_person": "amé",
"singular_second_person": "amaste",
"singular_formal_second_person": "amó",
"singular_third_person": "amó",
"plural_first_person": "amamos",
"plural_second_person": "amasteis",
"plural_formal_second_person": "amaron",
"plural_third_person": "amaron"
},
"past_anterior": {
"singular_first_person": "hube amado",
"singular_second_person": "hubiste amado",
"singular_formal_second_person": "hubo amado",
"singular_third_person": "hubo amado",
"plural_first_person": "hubimos amado",
"plural_second_person": "hubisteis amado",
"plural_formal_second_person": "hubieron amado",
"plural_third_person": "hubieron amado"
},
"future": {
"singular_first_person": "amaré",
"singular_second_person": "amarás",
"singular_formal_second_person": "amará",
"singular_third_person": "amará",
"plural_first_person": "amaremos",
"plural_second_person": "amaréis",
"plural_formal_second_person": "amarán",
"plural_third_person": "amarán"
},
"future_perfect": {
"singular_first_person": "habré amado",
"singular_second_person": "habrás amado",
"singular_formal_second_person": "habrá amado",
"singular_third_person": "habrá amado",
"plural_first_person": "habremos amado",
"plural_second_person": "habréis amado",
"plural_formal_second_person": "habrán amado",
"plural_third_person": "habrán amado"
},
"conditional": {
"singular_first_person": "amaría",
"singular_second_person": "amarías",
"singular_formal_second_person": "amaría",
"singular_third_person": "amaría",
"plural_first_person": "amaríamos",
"plural_second_person": "amaríais",
"plural_formal_second_person": "amarían",
"plural_third_person": "amarían"
},
"conditional_perfect": {
"singular_first_person": "habría amado",
"singular_second_person": "habrías amado",
"singular_formal_second_person": "habría amado",
"singular_third_person": "habría amado",
"plural_first_person": "habríamos amado",
"plural_second_person": "habríais amado",
"plural_formal_second_person": "habrían amado",
"plural_third_person": "habrían amado"
}
},
"subjunctive": {
"present": {
"singular_first_person": "ame",
"singular_second_person": "ames",
"singular_formal_second_person": "ame",
"singular_third_person": "ame",
"plural_first_person": "amemos",
"plural_second_person": "améis",
"plural_formal_second_person": "amen",
"plural_third_person": "amen"
},
"present_perfect": {
"singular_first_person": "haya amado",
"singular_second_person": "hayas amado",
"singular_formal_second_person": "haya amado",
"singular_third_person": "haya amado",
"plural_first_person": "hayamos amado",
"plural_second_person": "hayáis amado",
"plural_formal_second_person": "hayan amado",
"plural_third_person": "hayan amado"
},
"imperfect": {
"singular_first_person": "amara o amase",
"singular_second_person": "amaras o amases",
"singular_formal_second_person": "amara o amase",
"singular_third_person": "amara o amase",
"plural_first_person": "amáramos o amásemos",
"plural_second_person": "amarais o amaseis",
"plural_formal_second_person": "amaran o amasen",
"plural_third_person": "amaran o amasen"
},
"past_perfect": {
"singular_first_person": "hubiera o hubiese amado",
"singular_second_person": "hubieras o hubieses amado",
"singular_formal_second_person": "hubiera o hubiese amado",
"singular_third_person": "hubiera o hubiese amado",
"plural_first_person": "hubiéramos o hubiésemos amado",
"plural_second_person": "hubierais o hubieseis amado",
"plural_formal_second_person": "hubieran o hubiesen amado",
"plural_third_person": "hubieran o hubiesen amado"
},
"future": {
"singular_first_person": "amare",
"singular_second_person": "amares",
"singular_formal_second_person": "amare",
"singular_third_person": "amare",
"plural_first_person": "amáremos",
"plural_second_person": "amareis",
"plural_formal_second_person": "amaren",
"plural_third_person": "amaren"
},
"future_perfect": {
"singular_first_person": "hubiere amado",
"singular_second_person": "hubieres amado",
"singular_formal_second_person": "hubiere amado",
"singular_third_person": "hubiere amado",
"plural_first_person": "hubiéremos amado",
"plural_second_person": "hubiereis amado",
"plural_formal_second_person": "hubieren amado",
"plural_third_person": "hubieren amado"
}
},
"imperative": {
"singular_second_person": "ama / amá",
"singular_formal_second_person": "ame",
"plural_second_person": "amad",
"plural_formal_second_person": "amen"
}
}
}
],
"suggestions": null
},
"ok": true
} Nota: La respuesta incluye múltiples acepciones en senses, etimología en origin, y conjugaciones completas para
verbos en conjugations. Para sustantivos y adjetivos, el
campo conjugations será null.
Manejo de errores
Cuando una palabra no se encuentra, la API devuelve:
{
"ok": false,
"error": "NOT_FOUND",
"suggestions": ["amor", "amores", "amoroso"]
}Parámetros de búsqueda
Puedes personalizar las búsquedas usando parámetros en la URL:
Búsqueda difusa
Para buscar palabras similares cuando hay errores tipográficos:
curl 'https://rae-api.com/api/search?q=amorr&eng=hits'Palabra aleatoria
Para obtener una palabra aleatoria del diccionario:
curl https://rae-api.com/api/randomPalabra del día
Para obtener la palabra del día:
curl https://rae-api.com/api/dailyParámetros disponibles
-
q(requerido para search): La palabra o frase a buscar -
eng(opcional para search): Motor de búsqueda (linearohits) -
min_length(opcional para random): Longitud mínima de la palabra -
max_length(opcional para random): Longitud máxima de la palabra
Límites de velocidad
⚠️ Uso responsable
Por favor, respeta los límites de velocidad:
- Máximo 60 consultas por minuto para uso personal
- Máximo 1000 consultas por día para uso no comercial
- Para uso comercial, contacta para obtener una clave API
Siguientes pasos
Ahora que has realizado tu primera consulta, puedes:
- Explorar la documentación completa de la API
- Probar la API interactivamente en el API Explorer
- Consultar la especificación OpenAPI completa