Fix invalid URLs flagged by CRAN incoming pretest

OpenAlex moved its API documentation from docs.openalex.org to developers.openalex.org, so all old links now return 301 redirects.

Author: massimoaria

CRAN-SUBMISSION

@@ -1,3 +1,3 @@
-Version: 3.0.1
-Date: 2026-01-13 18:50:14 UTC
-SHA: 44daafc927e44f7e0ebd6631ea22820a4e6a9e12
+Version: 3.1.0
+Date: 2026-07-02 14:35:16 UTC
+SHA: 8b44f2fbba2756fd57248858126951a18f0f952f

DESCRIPTION

@@ -26,7 +26,7 @@ Authors@R: c(
            comment = c(ORCID = "0000-0002-0701-921X"))
     )
 Description: A set of tools to extract bibliographic content from
-    'OpenAlex' database using API <https://docs.openalex.org>.
+    'OpenAlex' database using API <https://developers.openalex.org/>.
 License: MIT + file LICENSE
 URL: https://github.com/ropensci/openalexR,
     https://docs.ropensci.org/openalexR/

R/oa2bibliometrix.R

@@ -1,7 +1,7 @@
 #' Convert OpenAlex collection from data frame to bibliometrix object
 #'
 #' It converts bibliographic collections gathered from OpenAlex database \href{https://openalex.org/}{https://openalex.org/} into a
-#' bibliometrix data frame (\href{https://bibliometrix.org/}{https://bibliometrix.org/})
+#' bibliometrix data frame (\href{https://www.bibliometrix.org/}{https://www.bibliometrix.org/})
 #' Column names follow https://images.webofknowledge.com/images/help/WOS/hs_wos_fieldtags.html.
 #'
 #' @param df is bibliographic collection of works downloaded from OpenAlex.

R/oa2df.R

@@ -178,7 +178,7 @@ process_records <- function(
 #'
 #' @return a data.frame.
 #'
-#' For more extensive information about OpenAlex API, please visit: <https://docs.openalex.org>
+#' For more extensive information about OpenAlex API, please visit: <https://developers.openalex.org/>
 #'
 #' @importFrom stats setNames
 #'
@@ -407,7 +407,7 @@ works2df <- function(
 #'
 #' @return a data.frame.
 #'
-#' For more extensive information about OpenAlex API, please visit: <https://docs.openalex.org>
+#' For more extensive information about OpenAlex API, please visit: <https://developers.openalex.org/>
 #'
 #'
 #' @examples
@@ -496,7 +496,7 @@ authors2df <- function(
 #'
 #' @return a data.frame.
 #'
-#' For more extensive information about OpenAlex API, please visit: <https://docs.openalex.org>
+#' For more extensive information about OpenAlex API, please visit: <https://developers.openalex.org/>
 #'
 #'
 #' @examples
@@ -602,7 +602,7 @@ institutions2df <- function(
 #'
 #' @return a data.frame.
 #'
-#' For more extensive information about OpenAlex API, please visit: <https://docs.openalex.org>
+#' For more extensive information about OpenAlex API, please visit: <https://developers.openalex.org/>
 #'
 #'
 #' @examples
@@ -731,7 +731,7 @@ keywords2df <- function(data, verbose = TRUE) {
 #'
 #' @return a data.frame.
 #'
-#' For more extensive information about OpenAlex API, please visit: <https://docs.openalex.org>
+#' For more extensive information about OpenAlex API, please visit: <https://developers.openalex.org/>
 #'
 #'
 #' @examples
@@ -788,7 +788,7 @@ funders2df <- function(
 #'
 #' @return a data.frame.
 #'
-#' For more extensive information about OpenAlex API, please visit: <https://docs.openalex.org>
+#' For more extensive information about OpenAlex API, please visit: <https://developers.openalex.org/>
 #'
 #'
 #' @examples
@@ -867,7 +867,7 @@ sources2df <- function(
 #'
 #' @return a data.frame.
 #'
-#' For more extensive information about OpenAlex API, please visit: <https://docs.openalex.org>
+#' For more extensive information about OpenAlex API, please visit: <https://developers.openalex.org/>
 #'
 #'
 #' @examples
@@ -926,7 +926,7 @@ publishers2df <- function(
 #'
 #' @return a data.frame.
 #'
-#' For more extensive information about OpenAlex API, please visit: <https://docs.openalex.org>
+#' For more extensive information about OpenAlex API, please visit: <https://developers.openalex.org/>
 #'
 #'
 #' @examples

R/oa_fetch.R

@@ -133,7 +133,7 @@ oa_fetch <- function(
   }
 
   # overcome OA limitation of combining 50 values (OR) for a filter at a time
-  # https://docs.openalex.org/how-to-use-the-api/get-lists-of-entities/filter-entity-lists#addition-or
+  # https://developers.openalex.org/guides/filtering
   # We can only chunk ONE filter at a time; more than one would require a
   # combinatorial set of requests, so we ask the user to split the call instead.
   large_filter <- which(lengths(filter) > 50)
@@ -239,7 +239,7 @@ oa_fetch <- function(
 #' When used with `options$sample` and or `pages`,
 #' paging is also automatically set to basic paging: `paging = "page"`
 #' to avoid duplicates and get the right page.
-#' See https://docs.openalex.org/how-to-use-the-api/get-lists-of-entities/paging.
+#' See https://developers.openalex.org/guides/page-through-results.
 #' @param pages Integer vector.
 #' The range of pages to return. If NULL, return all pages.
 #' @param count_only Logical.
@@ -260,7 +260,7 @@ oa_fetch <- function(
 #' @return a data.frame or a list of bibliographic records.
 #'
 #' For more extensive information about OpenAlex API, please visit:
-#' <https://docs.openalex.org>
+#' <https://developers.openalex.org/>
 #'
 #'
 #' @examples
@@ -547,7 +547,7 @@ oa_request <- function(
         "!" = "The following work{?s} {?has/have} truncated lists of authors: {.val {truncated}}.",
         "i" = "Query each work separately by its identifier to get full list of authors.",
         "i" = "For example: {.code lapply(c(\"{paste(utils::head(truncated, 2), collapse = '\", \"')}\"), \\(x) oa_fetch(identifier = x))}",
-        "i" = "Details at {.url https://docs.openalex.org/api-entities/authors/limitations}."
+        "i" = "Details at {.url https://developers.openalex.org/api-reference/authors}."
       ))
     }
   }
@@ -586,13 +586,13 @@ get_next_page <- function(paging, i, res = NULL) {
 #' condition--specifically, a particular value for a particular attribute.
 #' Filters are formatted as attribute = value.
 #' The complete list of filter attributes for each entity can be found at
-#' <https://docs.openalex.org/how-to-use-the-api/get-lists-of-entities/filter-entity-lists>.
+#' <https://developers.openalex.org/guides/filtering>.
 #' For example, `cited_by_count = ">100"`,
 #' `title.search = c("bibliometric analysis", "science mapping")`,
 #' or `to_publication_date = "2021-12-31"`.
 #' @param multiple_id Logical. Whether there are multiple identifiers.
 #' @param identifier Character. OpenAlex ID(s) as item identifier(s).
-#' See more at <https://docs.openalex.org/how-to-use-the-api/get-single-entities#the-openalex-id>.
+#' See more at <https://developers.openalex.org/guides/get>.
 #' @param entity Character. Scholarly entity of the search.
 #' The argument can be one of
 #' c("works", "authors", "institutions", "keywords", "funders", "sources", "publishers", "topics").
@@ -612,7 +612,7 @@ get_next_page <- function(paging, i, res = NULL) {
 #' To filter using search, append .search to the end of the attribute you're filtering for.
 #' @param group_by Character. Attribute to group by.
 #' For example: "oa_status" for works.
-#' See more at <https://docs.openalex.org/how-to-use-the-api/get-groups-of-entities>.
+#' See more at <https://developers.openalex.org/guides/grouping>.
 #' @param endpoint Character. URL of the OpenAlex Endpoint API server.
 #' Defaults to endpoint = "https://api.openalex.org".
 #' @param verbose Logical. If TRUE, print information on querying process.
@@ -624,7 +624,7 @@ get_next_page <- function(paging, i, res = NULL) {
 #' @return a character containing the query in OpenAlex format.
 #'
 #' For more extensive information about OpenAlex API, please visit:
-#' <https://docs.openalex.org>.
+#' <https://developers.openalex.org/>.
 #'
 #'
 #' @examples

R/oa_ngrams.R

@@ -21,13 +21,13 @@ ngram2df <- function(ngram) {
 #'
 #' Some work entities in OpenAlex include N-grams (word sequences and their frequencies) of their full text.
 #' The N-grams are obtained from Internet Archive, which uses the spaCy parser to index scholarly works.
-#' See <https://docs.openalex.org/api-entities/works/get-n-grams> for coverage and more technical details.
+#' See <https://developers.openalex.org/guides/deprecations> for coverage and more technical details.
 #'
 #' @note A faster implementation is available for `curl` >= v5.0.0, and `oa_ngrams` will issue a one-time message
 #' about this. This can be suppressed with `options("oa_ngrams.message.curlv5" = FALSE)`.
 #'
 #' @param works_identifier Character. OpenAlex ID(s) of "works" entities as item identifier(s).
-#' These IDs start with "W". See more at <https://docs.openalex.org/api-entities/works#id>.
+#' These IDs start with "W". See more at <https://developers.openalex.org/api-reference/works>.
 #' @param ... Unused.
 #' @inheritParams oa_query
 #'

R/oa_options.R

@@ -14,14 +14,14 @@
 #'
 #' @param select Character vector. Top-level fields to show in output.
 #' Defaults to NULL, which returns all fields.
-#' <https://docs.openalex.org/how-to-use-the-api/get-single-entities/select-fields>
+#' <https://developers.openalex.org/guides/selecting-fields>
 #' @param sort Character. Attribute to sort by.
 #' For example: "display_name" for sources or "cited_by_count:desc" for works.
-#' See more at <https://docs.openalex.org/how-to-use-the-api/get-lists-of-entities/sort-entity-lists>.
+#' See more at <https://developers.openalex.org/guides/sort>.
 #' @param sample Integer. Number of (random) records to return.
 #' Should be no larger than 10,000.
 #' Defaults to NULL, which returns all records satisfying the query.
-#' Read more at <https://docs.openalex.org/how-to-use-the-api/get-lists-of-entities/sample-entity-lists>.
+#' Read more at <https://developers.openalex.org/api-reference/works/list-works>.
 #' @param seed Integer.
 #' A seed value in order to retrieve the same set of random records in
 #' the same order when used multiple times with `sample`.
@@ -36,7 +36,7 @@
 #' Either "cursor" for cursor paging or "page" for basic paging.
 #' When used with `sample` and/or `pages`, paging is automatically set to
 #' basic paging (`paging = "page"`) to avoid duplicates and get the right page.
-#' See <https://docs.openalex.org/how-to-use-the-api/get-lists-of-entities/paging>.
+#' See <https://developers.openalex.org/guides/page-through-results>.
 #' @param pages Integer vector.
 #' The range of pages to return. If NULL, return all pages.
 #' @param ... Additional query parameters forwarded to the OpenAlex API

README.Rmd

@@ -65,7 +65,7 @@ install.packages("openalexR")
 Without a key, you are limited to 100 credits per day (for testing only).
 With a free API key, you get 100,000 credits per day.
 
-See the [OpenAlex API access documentation](https://docs.openalex.org/#access) for details.
+See the [OpenAlex API access documentation](https://developers.openalex.org/guides/authentication) for details.
 
 **To get your API key:**
 
@@ -102,7 +102,7 @@ knitr::opts_chunk$set(dev.args = list(bg = "transparent"))
 
 ## 🌿 Examples
 
-There are different [filters](https://ropensci.github.io/openalexR/articles/Filters)/arguments you can use in `oa_fetch`, depending on which [entity](https://docs.openalex.org/#data) you're interested in: 
+There are different [filters](https://ropensci.github.io/openalexR/articles/Filters)/arguments you can use in `oa_fetch`, depending on which [entity](https://developers.openalex.org/guides/key-concepts) you're interested in: 
 `r cat(setdiff(oa_entities(), "concepts"), sep = ", ")`.
 We show a few examples below.
 
@@ -383,10 +383,10 @@ ggraph(graph = as_tbl_graph(snowball_docs), layout = "stress") +
 
 ## 🌾 N-grams
 
-**Update 2024-09-15**: The n-gram API endpoint is [not currently in service](https://docs.openalex.org/api-entities/works/get-n-grams#api-endpoint).
+**Update 2024-09-15**: The n-gram API endpoint is [not currently in service](https://developers.openalex.org/guides/deprecations).
 The following code chunk is not evaluated.
 
-OpenAlex offers (limited) support for [fulltext N-grams](https://docs.openalex.org/api-entities/works/get-n-grams#fulltext-coverage) of Work entities (these have IDs starting with `"W"`). Given a vector of work IDs, `oa_ngrams` returns a dataframe of N-gram data (in the `ngrams` list-column) for each work.
+OpenAlex offers (limited) support for [fulltext N-grams](https://developers.openalex.org/guides/deprecations) of Work entities (these have IDs starting with `"W"`). Given a vector of work IDs, `oa_ngrams` returns a dataframe of N-gram data (in the `ngrams` list-column) for each work.
 
 ```{r ngrams, eval=FALSE, fig.height=3}
 ngrams_data <- oa_ngrams(
@@ -414,7 +414,7 @@ ngrams_data |>
   )
 ```
 
-`oa_ngrams` can sometimes be slow because the N-grams data can get pretty big, but given that the N-grams are [`"cached via CDN"`](<https://docs.openalex.org/api-entities/works/get-n-grams#api-endpoint>), you may also consider parallelizing for this special case (`oa_ngrams` does this automatically if you have `{curl} >= v5.0.0`).
+`oa_ngrams` can sometimes be slow because the N-grams data can get pretty big, but given that the N-grams are [`"cached via CDN"`](<https://developers.openalex.org/guides/deprecations>), you may also consider parallelizing for this special case (`oa_ngrams` does this automatically if you have `{curl} >= v5.0.0`).
 
 ## 💫 About OpenAlex
 

README.md

@@ -79,7 +79,7 @@ Without a key, you are limited to 100 credits per day (for testing
 only). With a free API key, you get 100,000 credits per day.
 
 See the [OpenAlex API access
-documentation](https://docs.openalex.org/#access) for details.
+documentation](https://developers.openalex.org/guides/authentication) for details.
 
 **To get your API key:**
 
@@ -109,7 +109,7 @@ library(ggplot2)
 There are different
 [filters](https://ropensci.github.io/openalexR/articles/Filters)/arguments
 you can use in `oa_fetch`, depending on which
-[entity](https://docs.openalex.org/#data) you’re interested in: . We
+[entity](https://developers.openalex.org/guides/key-concepts) you’re interested in: . We
 show a few examples below.
 
 ### 📚 Works
@@ -579,11 +579,11 @@ ggraph(graph = as_tbl_graph(snowball_docs), layout = "stress") +
 ## 🌾 N-grams
 
 **Update 2024-09-15**: The n-gram API endpoint is [not currently in
-service](https://docs.openalex.org/api-entities/works/get-n-grams#api-endpoint).
+service](https://developers.openalex.org/guides/deprecations).
 The following code chunk is not evaluated.
 
 OpenAlex offers (limited) support for [fulltext
-N-grams](https://docs.openalex.org/api-entities/works/get-n-grams#fulltext-coverage)
+N-grams](https://developers.openalex.org/guides/deprecations)
 of Work entities (these have IDs starting with `"W"`). Given a vector of
 work IDs, `oa_ngrams` returns a dataframe of N-gram data (in the
 `ngrams` list-column) for each work.
@@ -616,7 +616,7 @@ ngrams_data |>
 
 `oa_ngrams` can sometimes be slow because the N-grams data can get
 pretty big, but given that the N-grams are
-[`"cached via CDN"`](https://docs.openalex.org/api-entities/works/get-n-grams#api-endpoint),
+[`"cached via CDN"`](https://developers.openalex.org/guides/deprecations),
 you may also consider parallelizing for this special case (`oa_ngrams`
 does this automatically if you have `{curl} >= v5.0.0`).
 

cran-comments.md

@@ -1,5 +1,16 @@
+## Resubmission
+
+This is a resubmission of version 3.1.0. It fixes the (possibly) invalid
+URLs reported by the CRAN incoming pretest:
+
+* All links to the OpenAlex documentation (`https://docs.openalex.org/...`)
+  were updated to the new documentation site
+  (`https://developers.openalex.org/...`), as the old site now permanently
+  redirects there.
+* `https://bibliometrix.org/` was updated to `https://www.bibliometrix.org/`.
+
 * Small patch to use string for package version comparison
 
 ## R CMD check results
 
-0 errors | 0 warnings | 0 note
+0 errors | 0 warnings | 0 notes