Actions5
- Name API Actions
- Links API Actions
- Text API Actions
Overview
This node interacts with the Sefaria API to retrieve Jewish textual data based on a specific reference, language, and version. The "Get Texts By Ref Lang Version" operation fetches the text content for a given reference (e.g., "Shabbat.1a") in the specified language and version. It optionally includes related commentaries, controls context inclusion, and manages how references are padded to section levels.
Common scenarios include:
- Retrieving classical Jewish texts for study or display in apps.
- Fetching specific segments of texts for educational platforms.
- Including commentaries or cross-references to enrich textual analysis.
- Controlling the granularity of text retrieval (single segment vs. entire sections).
Example use case: A user wants to display the Hebrew text of "Shabbat 1a" along with its commentaries and without extra surrounding context.
Properties
| Name | Meaning |
|---|---|
| Ref | Valid reference string identifying the text segment, e.g., "Shabbat.1a". |
| Lang | Language code for the text, e.g., "en" for English or "he" for Hebrew. |
| Version | Version identifier of the text to retrieve, typically a number as a string, e.g., "1". |
| Commentary | Include known connections to other texts (commentaries). Values: 1 (include), 0 (exclude). |
| Context | Controls whether surrounding texts are returned when requesting a single segment. Values: 1 (default, include context), 0 (suppress context). |
| Pad | Controls padding behavior of references to section level. Values: 1 (default, pad to section), 0 (no padding, e.g., "Genesis" returns whole book). |
Output
The node outputs JSON data representing the requested text segment(s) from the Sefaria API. This includes the main text content in the specified language and version. If enabled, it also includes commentary links and possibly surrounding context depending on the parameters.
No binary data output is indicated by the source.
Dependencies
- Requires access to the Sefaria API endpoint (default base URL: https://www.sefaria.org).
- Optionally uses an API key credential if configured (not mandatory).
- No additional external dependencies beyond standard HTTP requests.
Troubleshooting
- Invalid Reference Error: If the "Ref" property is malformed or does not exist in Sefaria, the API will return an error. Verify the reference format (e.g., "Shabbat.1a").
- Language or Version Not Found: Specifying unsupported language codes or versions may result in empty or error responses. Confirm available languages and versions on Sefaria.
- Context or Padding Misconfiguration: Setting "context" or "pad" incorrectly might lead to unexpected amounts of text returned. Adjust these flags according to desired granularity.
- Network or Authentication Issues: Ensure network connectivity to the Sefaria API and that any required authentication tokens are correctly set up in n8n credentials.