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 specified reference and language. Specifically, the "Get Texts By Ref Lang" operation fetches texts from the Sefaria library by providing a valid text reference (e.g., "Shabbat.1a") and a language code (e.g., "en" for English or "he" for Hebrew). This is useful for applications that need to display or process traditional Jewish texts programmatically, such as study tools, educational apps, or research platforms.
Practical examples include:
- Retrieving the Hebrew text of a specific Talmudic passage.
- Fetching English translations of biblical verses.
- Including commentaries and cross-references related to a given text segment.
Properties
| Name | Meaning |
|---|---|
| Ref | A valid text reference string identifying the desired text segment (e.g., "Shabbat.1a"). |
| Lang | Language code specifying the language of the returned text (e.g., "en" for English, "he" for Hebrew). |
| Commentary | Option to include known connections to other texts along with the requested text. Values: 0 (exclude), 1 (include). |
| Context | Controls whether surrounding texts are included when only a single segment is requested. Values: 0 (suppress surrounding texts), 1 (include surrounding texts). |
| Pad | Determines if the reference should be padded down to section level or return the entire book. Values: 0 (no padding), 1 (pad to section level). |
Output
The node outputs JSON data containing the requested text(s) from the Sefaria API. The structure typically includes the text content in the specified language, and optionally commentaries and contextual segments depending on the input parameters.
If commentaries are included, the output will contain additional fields listing related texts and their connections.
No binary data output is indicated for this operation.
Dependencies
- Requires access to the Sefaria API endpoint (default base URL: https://www.sefaria.org).
- Optionally requires an API key credential if the Sefaria API enforces authentication (not explicitly shown in the source).
- No other external dependencies are indicated.
Troubleshooting
- Invalid Reference Error: If the provided "Ref" value does not correspond to a valid Sefaria text reference, the API may return an error or empty result. Verify the reference format and correctness.
- Unsupported Language: Providing a language code not supported by the API may result in missing or incomplete text data.
- Network Issues: Connectivity problems to the Sefaria API endpoint can cause request failures.
- Parameter Conflicts: Setting contradictory values for "Context" and "Pad" might lead to unexpected results; ensure parameters align with intended behavior.