royalsocietypublishing.org APIroyalsocietypublishing.org ↗
Access journals, issues, and articles from Royal Society Publishing. Retrieve metadata, abstracts, DOIs, authors, and subject browsing across 11 journals.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/1aaa9342-35e0-404d-9ef4-f0527395abd3/list_journals' \ -H 'X-API-Key: $PARSE_API_KEY'
Get list of all Royal Society journals with their short codes, names, and URLs. Returns a static list of 11 journals.
No input parameters required.
{
"type": "object",
"fields": {
"data": "array of journal objects, each with code, name, and url"
},
"sample": {
"data": [
{
"url": "https://royalsocietypublishing.org/rsbl",
"code": "rsbl",
"name": "Biology Letters"
},
{
"url": "https://royalsocietypublishing.org/rspb",
"code": "rspb",
"name": "Proceedings of the Royal Society B: Biological Sciences"
}
],
"status": "success"
}
}About the royalsocietypublishing.org API
The Royal Society Publishing API provides structured access to 11 peer-reviewed journals through 9 endpoints, covering journal metadata, issue archives, and individual article details. The get_article_details endpoint returns title, authors, abstract, keywords, DOI, publication date, and citation metrics for any article identified by DOI or URL. Endpoints also support year-based issue listing, subject browsing, and cross-journal article search.
Journal and Issue Access
The list_journals endpoint returns all 11 Royal Society journals with their short codes (e.g. rsbl, rsta, rspb), names, and URLs. Those codes are the primary key across the API — get_journal_info accepts a journal_code and returns the journal's description, ISSN, eISSN, and impact factor when present. get_current_issue and get_issue both return volume, issue number, publication date, and an articles array where each item includes title, authors, DOI, and URL. list_issues_by_year takes a four-digit year and a journal_code and returns each issue's volume, issue number, URL, and date.
Article Details and Search
get_article_details resolves a single article by doi or url — at least one must be supplied. The response object includes title, an authors array, abstract, a keywords array, publication_date, journal, doi, and a metrics object covering citation and access signals when available on the article page. Fields may be empty strings if the data is absent on the source page.
search_articles runs a free-text query across all journals and returns paginated results with title, authors, doi, url, and abstract_excerpt. browse_by_subject filters on a numeric subject_id (e.g. 24 for behaviour, 104 for ecology) and returns the same article shape. get_latest_articles accepts an optional journal_code to narrow results and returns articles sorted by publication date descending.
Coverage Notes
All endpoints that accept a journal_code recognise exactly 11 values: rsbm, rsbl, rsif, rsfs, rsnr, rsob, rsta, rstb, rspa, rspb, rsos. Some fields — impact factor, metrics, keywords — are conditionally populated depending on what the article or journal page exposes. The API does not currently include full-text article bodies or supplementary material.
- Build a citation lookup tool that resolves a DOI to title, authors, abstract, and metrics via
get_article_details. - Aggregate all articles published in a specific year for a given journal using
list_issues_by_yearcombined withget_issue. - Monitor new Royal Society publications in a chosen field by polling
browse_by_subjectwith a relevantsubject_id. - Populate a literature review dashboard with cross-journal search results from
search_articles. - Track the current issue of multiple journals by calling
get_current_issuefor eachjournal_code. - Compare ISSN, eISSN, and impact factor across all 11 journals by iterating
get_journal_infoover the codes fromlist_journals. - Feed a research alert service with
get_latest_articlesfiltered by a specific journal code.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Royal Society Publishing have an official developer API?+
What does `get_article_details` return, and what inputs does it accept?+
doi (e.g. 10.1098/rsbl.2025.0633) or a full url on royalsocietypublishing.org — at least one is required. The response includes title, an authors array, abstract, a keywords array, publication_date, journal name, doi, and a metrics object. Fields are empty strings when the data is not present on the article page.Are full-text article bodies available through this API?+
How does subject browsing work, and where do subject IDs come from?+
browse_by_subject endpoint takes a numeric subject_id string — for example, 24 for behaviour or 104 for ecology. These IDs correspond to subject category identifiers used on the Royal Society Publishing site. The endpoint does not expose a list of all valid subject IDs; you would need to identify relevant IDs from the site's subject browse pages and supply them directly.