Search → Get
AI-generatedOverview
This node integrates with the Unpaywall API to retrieve open access scholarly content metadata. Specifically, for the Search - Get operation, it allows users to perform a search query against Unpaywall's database of academic articles and returns matching results. This is useful for researchers, librarians, or developers who want to programmatically find open access articles based on keywords or other search criteria.
Practical examples include:
- Searching for all open access articles related to "climate change" to build a dataset.
- Filtering search results to only include open access publications.
- Paginating through large result sets by specifying the page number.
Properties
| Name | Meaning |
|---|---|
| Your email address required by Unpaywall to use their API; used for contact in case of issues. | |
| Search Query | The search string or keywords to query Unpaywall's article database. |
| Is Open Access | Boolean filter to include only open access articles (true) or non-open access articles (false). |
| Results Page | Number indicating which page of results to return (minimum value 1). |
Output
The node outputs an array of JSON objects representing individual search results from Unpaywall. Each object corresponds to a scholarly article matching the search query and includes metadata such as title, authors, publication details, and open access status.
No binary data output is produced by this operation.
Dependencies
- Requires internet access to call the Unpaywall public API.
- Requires the user to provide a valid email address as part of the input properties, which Unpaywall uses for contact purposes.
- No additional credentials or environment variables are needed beyond the email input.
Troubleshooting
- Missing or invalid email: The API requires a valid email address. If omitted or malformed, requests may fail or be rejected.
- Empty or invalid search query: Providing an empty search query will likely return no results or an error.
- API rate limits: Excessive requests might trigger rate limiting by Unpaywall; consider adding delays or pagination.
- Page number out of range: Specifying a page number less than 1 may cause errors; ensure the page number is at least 1.
- Network issues: Connectivity problems will prevent API calls from succeeding.
Common error messages typically relate to HTTP request failures or validation errors from the API. To resolve, verify inputs, ensure network connectivity, and confirm compliance with Unpaywall's usage policies.