easyScieloPack (version 0.1.1)

search_scielo: 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
)

Value

A data.frame with the search results.

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).

Examples

if (FALSE) { # interactive()
# \donttest{
# 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)
# }
}