Real Academia Española (RAE) API Scraper

Overview

This actor fetches detailed lexical data from the official Real Academia Española (RAE) dictionary API. It returns structured JSON containing definitions, etymologies, synonyms, and related expressions for given Spanish words.

Key Features

• Comprehensive Data: Retrieves multiple definitions, parts of speech, examples, etymologies, synonyms (both per-sense and global), and related expressions.
• Structured JSON Output: Data is delivered in a consistent, parseable format.
• Direct Source: Pulls data directly from the official RAE API for accuracy.
• Configurable Limit: Optionally limit the number of definitions returned per word (10-100).

How to Use

Provide an input object specifying the words to look up. The actor will scrape the RAE API and return the corresponding data for each.

Input

The input must be a JSON object with a words array and an optional limit.

{
  "words": ["mar", "agua"],
  "limit": 20
}

• words (required): Array of Spanish words (e.g., ["mar", "agua"]).
• limit (optional): Maximum definitions per word. Must be between 10 and 100. Defaults to 100.

Output

The output is an array of definition objects for each word. If a word has no results in the RAE dictionary, the actor provides placeholder data.

Each definition object includes:
* word: The word or expression being defined.
* sense: The sense number (e.g., "1.").
* part_of_speech: Grammatical category (e.g., "nombre masculino o femenino").
* additional_info: Array for usage notes or metadata.
* definition: The textual meaning.
* example: An example sentence, if available.
* synonyms: Array of synonyms specific to this sense.

Example Output Snippet

For the word "mar", a definition object looks like:

{
  "word": "mar",
  "sense": "1.",
  "part_of_speech": "nombre masculino o femenino",
  "additional_info": [],
  "definition": "Masa de agua salada que cubre la mayor parte de la superficie terrestre.",
  "example": null,
  "synonyms": ["océano", "piélago", "agua", "ponto", "profundo"]
}