search_scielo {easyScieloPack} | R Documentation |
Search SciELO and return results as a data.frame
Description
Executes a search in the SciELO database using multiple optional filters, and returns the results as a data frame.
Usage
search_scielo(
query,
lang = "en",
lang_operator = "AND",
n_max = NULL,
journals = NULL,
collections = NULL,
languages = NULL,
categories = NULL,
year_start = NULL,
year_end = NULL
)
Arguments
query |
Search term (e.g., "climate change"). Required. |
lang |
Interface language for SciELO website ("en", "es", "pt"). Default is "en". |
lang_operator |
Operator for combining language filters ("AND" or "OR"). Default is "AND". |
n_max |
Maximum number of results to return. Optional. |
journals |
Vector of journal names to filter. Only one supported. Optional. |
collections |
A character string for filtering by SciELO collection (country name or ISO code, e.g., "Mexico" or "mex"). |
languages |
Vector of article languages to filter (e.g., "en"). |
categories |
Vector of subject categories (e.g., "ecology"). |
year_start |
Start year for filtering articles. Optional. |
year_end |
End year for filtering articles. Optional. |
Details
Note: Only one value per filter category is currently supported (e.g., only one language).
Value
A data.frame with the search results.
Examples
# Simple search with a keyword
df1 <- search_scielo("salud ambiental")
# Limit number of results to 5
df2 <- search_scielo("salud ambiental", n_max = 5)
# Filter by SciELO collection (country name or code)
df3 <- search_scielo("salud ambiental", collections = "Ecuador")
df4 <- search_scielo("salud ambiental", collections = "cri") # Costa Rica by ISO code
# Filter by article language
df5 <- search_scielo("salud ambiental", languages = "es")
# Filter by a specific journal
df6 <- search_scielo("salud ambiental", journals = "Revista Ambiente & Agua")
# Filter by subject category
df7 <- search_scielo("salud ambiental", categories = "environmental sciences")
# Filter by year range
df8 <- search_scielo("salud ambiental", year_start = 2015, year_end = 2020)