Skip to main content

Elsevier Developer Portal

Default API Key Settings

An API key has specific API resources, quotas, and service levels enabled by default.

Access to certain APIs is not enabled by default, because they require additional permission from Elsevier.

Subscriber and non-subscriber are distinguished by the IP address from which the requests to the API are being made. For example, when a call to the Abstract Retrieval API comes from within a network that is configured for access to Scopus, then the response fits the "subscriber" column. When that same call comes from an anonymous IP address, the response fits the "non-subscriber" column.

Quotas are reset every 7 days.

Review quota using the following response headers:

X-RateLimit-Limit       <----Shows API quota setting
X-RateLimit-Remaining   <----Shows API remaining quota
X-RateLimit-Reset       1234567891 <----Date/Time in Epoch seconds when API quota resets

When quota is exceeded, X-RateLimit-Limit and X-RateLimit-Remaining don't return. Instead, the APIs deliver an http 429 TOO MANY REQUESTS msg, along with the following response headers:

X-ELS-Status            QUOTA_EXCEEDED - Quota Exceeded
X-RateLimit-Reset       1234567891 <----Date/Time in Epoch seconds

Quota limits are per API, not a single global setting for a given APIKey.

Throttling Rates are listed in the table below in column requests/second. If requests exceed the throttling rate, the APIs also return an http 429 TOO MANY REQUESTS msg

Scopus APIs

# API Name Enabled or Disabled Non-subscriber Academic Subscriber Weekly Quota Requests/second
1 Serial Title Enabled STANDARD, COVERIMAGE views / Default 25 results / Max 200 results STANDARD, COVERIMAGE, ENHANCED Default 25 results / Max 200 results 20,000 6
2 Citations Count Metadata Enabled N/A STANDARD view / Default 25 results / Max 200 results 50,000 10
3 Citations Overview Disabled N/A STANDARD view / Default 25 results / Max 200 results 20,000 4
4 Subject Classifications Enabled No restrictions No restrictions N/A N/A
5 Abstract Retrieval Enabled META view All views, default FULL view 10,000 9
6 Affiliation Retrieval Enabled N/A All views, default STANDARD view 5,000 9
7 Author Retrieval Enabled N/A All views, default STANDARD view 5,000 3
8 Affiliation Search Enabled N/A Default 25 results / Max 200 results
5000 item result limit
5,000 6
9 Author Search Enabled N/A Default 25 results / Max 200 results
5000 item result limit
5,000 2
10 Scopus Search Enabled STANDARD view / Default 25 results STANDARD view / Max 200 results
COMPLETE view / Max 25 results
COMPONENT view / Max 25 results
5000 item total result limit without 'cursor' pagination. See Q4 of FAQ
20,000 9
11 Author Feedback Disabled N/A N/A N/A N/A

ScienceDirect APIs

#   API Name Enabled or Disabled Non-subscriber Subscriber Weekly Quota Requests/second
1 Serial Title Enabled STANDARD, COVERIMAGE views / Default 25 results / Max 200 results STANDARD, COVERIMAGE, ENHANCED Default 25 results / Max 200 results 20,000 6
2 Nonserial Title Enabled STANDARD, COVERIMAGE views / Default 25 results / Max 200 results STANDARD, COVERIMAGE views / Default 25 results / Max 200 results 20,000 6
3 Subject Classifications Enabled No restrictions No restrictions N/A N/A
4 Article Retrieval Enabled META, META_ABS view, OpenAccess Articles All Subscribed, OpenAccess and Complimentary Articles 50,000
Unlimited for Text Mining API keys
10
5 Article ("Full-Text") Entitlement Disabled N/A N/A N/A 6
6 Article Hosting Permissions Disabled N/A Provides open access information for a single full text article. N/A 6
7 Article Metadata API Enabled N/A 25 results - a field restricted search against ScienceDirect serial/nonserial full-text articles
6000 item total results limit
N/A 6
10 ScienceDirect Search v2 Enabled N/A STANDARD view / Max 200 results
6000 item total results limit
20,000 2
11 ScienceDirect ("Electronic") Holdings Report Disabled N/A N/A N/A 2

SciVal API

# API Name Enabled or Disabled Non-subscriber Subscriber Weekly Quota Requests/second
1 SciVal Author Lookup Enabled N/A Default 100 results / Max 500 results *5000 6
2 SciVal Country Lookup Enabled N/A Maximum 100 results for Metrics resource
No limit on total results (varies by resource)
*5000 6
3 SciVal Country Group Lookup Enabled N/A Maximum 100 results for Metrics resource
No limit on total results (varies by resource)
*5000 6
4 SciVal Institution Lookup Enabled N/A Maximum 100 results for Metrics resource
No limit on total results (varies by resource)
*5000 6
5 SciVal Institution Group Lookup Enabled N/A Maximum 100 results for Metrics resource
No limit on total results (varies by resource)
*5000 6
6 SciVal Publication Lookup Enabled N/A Maximum 100 results for Metrics resource
No limit on total results (varies by resource)
*5000 6
7 SciVal Scopus Source Lookup Enabled N/A Maximum 100 results for Metrics resource
No limit on total results (varies by resource)
*5000 6
8 SciVal Subject Area Enabled N/A Maximum 100 results for Metrics resource
No limit on total results (varies by resource)
*5000 6
9 SciVal Topic Lookup Enabled N/A Maximum 100 results for Metrics resource
No limit on total results (varies by resource)
*5000 6
10 SciVal Topic Cluster Lookup Enabled N/A Maximum 100 results for Metrics resource
No limit on total results (varies by resource)
*5000 6
11 SciVal World Lookup Enabled N/A Maximum 100 results for Metrics resource
No limit on total results (varies by resource)
*5000 6
*All SciVal APIs share a single quota pool of 5000 requests per APIKey.

Embase APIs

# API Name Enabled or Disabled Non-subscriber Subscriber Weekly Quota Requests/second
1 Embase Search Disabled N/A Default 25 results
No limit on total results
N/A 6
2 Embase Retrieval Disabled N/A 1 document per request N/A 6

Engineering Village APIs

# API Name Enabled or Disabled Non-subscriber Subscriber Weekly Quota Requests/second
1 Engineering Village Search Disabled N/A Default 25 results N/A N/A
2 Engineering Village Retrieval Disabled N/A 1 document per request N/A N/A


Geofacets API

# API Name Enabled or Disabled Non-subscriber Subscriber Weekly Quota Requests/second
1 Geofacets API Disabled N/A Default 25 results N/A 10

Pharmapendium APIs

# API Name Enabled or Disabled Non-subscriber Subscriber Weekly Quota Requests/second
1 Pharmapendium API Disabled N/A Variable, depending on request N/A 6

PlumX API

# API Name Enabled or Disabled Non-subscriber Subscriber Weekly Quota Requests/second
1 PlumX Metrics Enabled N/A 1 request per metric type N/A 6

SUSHI COP5 API

# API Name Enabled or Disabled Non-subscriber Subscriber Weekly Quota Requests/second
1 SUSHI COP5 API Disabled N/A 1 report request, some report requests start backline preprocessing instead of immediate delivery N/A 10