Sefaria icon

Sefaria

Interact with Sefaria API

Actions5

Overview

This node interacts with the Links API of the Sefaria platform to retrieve textual links related to a specified reference. It is useful for users who want to explore connections between different Jewish texts, such as Talmudic or Biblical references, by fetching all linked sources associated with a given text segment.

Common scenarios include:

  • Academic research where one needs to find all commentaries or related texts linked to a specific reference.
  • Building study tools that display interconnected texts dynamically.
  • Enriching content with contextual links from classical Jewish literature.

For example, providing the reference "Shabbat.1a" will return all links connected to that page of the Talmud, optionally including the actual text segments if requested.

Properties

Name Meaning
Ref The textual reference to query links for, e.g., "Shabbat.1a". This must be a valid reference string recognized by the API.
With Text Option to include the text segment from the reference in each result. Possible values: 0 (exclude text), 1 (include text). Default is 1.

Output

The node outputs JSON data containing an array of link objects related to the specified reference. Each object typically includes details about the linked text, such as its reference and possibly the text snippet itself if the "With Text" option is enabled.

If binary data output were supported, it would represent any non-JSON content returned by the API, but this node focuses on JSON responses only.

Dependencies

  • Requires access to the Sefaria API endpoint, defaulting to https://www.sefaria.org.
  • If authentication is needed, the node supports configuring an API key credential (referred generically as an API authentication token).
  • No additional external dependencies beyond standard HTTP request capabilities.

Troubleshooting

  • Invalid Reference Error: If the provided "Ref" value is not recognized by the API, the node may return an error or empty results. Ensure the reference string matches the expected format (e.g., "BookName.chapter" or "Tractate.page").
  • Network Issues: Failure to connect to the Sefaria API endpoint could cause timeouts or connection errors. Verify network connectivity and API availability.
  • Missing or Invalid Credentials: If the API requires authentication and credentials are not set or invalid, the node will fail. Provide a valid API authentication token if necessary.
  • Unexpected Response Format: Changes in the API response structure might cause parsing issues. Check for updates in the API documentation if errors occur.

Links and References

Discussion