Reasonable Use

The purpose of the API is to help support complex analytical tasks that could not otherwise be achieved through use of the Dimensions platform.

It is not intended to be used to create local copies of the Dimensions data for use as an alternative to the API, which should remain as the primary source of the data, or for training purposes. You should limit your use to what is necessary for the particular analytical task you are performing, not multiple or undefined use cases, and never in a way which may have an adverse impact on the performance or others’ use of the API.

If you require access to substantial volumes of Dimensions data, please let us know so that we can advise on the most appropriate means of getting that access.

If access is authorized via MCP, this is allowed at our discretion for convenience only, use restrictions and limitations must still be fully respected (never by-passed or circumvented), and you must not make use of the API in a manner that (in our absolute discretion) exceeds reasonable usage patterns. Without limiting that discretion, we may determine unreasonable usage by comparing your activity for any given period against the average of other users not making use of an MCP.

Your subscription to use the API may include a defined number of tokens. Any tokens generated in excess of that number may be revoked without notice, or subject to additional charges.

We reserve the right to impose such limits on the API as we consider are reasonable. Any account associated with a violation of these rules may be subject to enforcement action, including suspension. Please also make sure you comply with the other terms of your Dimensions subscription.

Technical Limits

To ensure good performance for all API users, the following general limits apply and cannot be modified:

  1. max. 30 requests per IP address per minute

  2. max. number of items used in in filter clause: up to 400, example: search publications where id in [...]

  3. max. number of boolean filter conditions: up to 100, example: search publications where field1 = value and field2 = value

  4. max. number of boolean full text clauses: up to 100, example: search publications in authors for "\"Alan Turing\" OR \"Stephen Hawking\""

  5. max. number of records that can be returned in a single query: 1,000

  6. max. number of records than can be returned for a single search, using pagination (limit and skip), with max. 1,000 records per page: 50,000

  7. max. number of records that can be returned when returning facets: 1,000 (no pagination possible)