Analytics API, Version 2.15

DATE: May 13, 2026

AUTHOR: Dimensions product team

Dimensions Analytics API v2.15 Release Notes

This release introduces more granular control for semantic search functions, a new machine learning-based relevance field for publications, and several schema updates to improve data consistency across entities.

New Features & Enhancements

Configurable Concept Extraction in `similar_documents`

The similar_documents function now supports an optional limit argument. This allows you to specify the maximum number of concepts to be extracted from an abstract during a search.

Default: 250 concepts.
Maximum: 2000 concepts.
Details: Adjusting this limit provides better control over the breadth and specificity of the concepts used to identify similar records.

New Field: `concepts_relevant` in Publications

A new field, concepts_relevant, has been added to the Publications entity.

Definition: This field contains concepts describing the primary topics of a publication, automatically derived using machine learning.
Filter: To ensure high accuracy, it only includes concepts with a relevance score of 0.6 or higher.

Deprecations and Schema Updates

To standardize our data model and improve multi-value handling, the following fields are now deprecated. Please migrate to the recommended replacements to ensure future compatibility.

Entity	Deprecated Field	Recommended Replacement
Publications	`research_org_country_names`	`research_org_countries`
Publications	`research_org_state_names`	`research_org_states`
Datasets	`title_language`, `language_desc`	`language_detected`
Organizations	`acronym`	`acronyms`
Grants	`funder_org_acronym`	`funders` (via `funders.acronyms`)

Note: While deprecated fields remain accessible for now to prevent breaking changes, we recommend updating your integrations to the new fields as soon as possible to ensure future compatibility.

For full technical details and implementation examples, visit the official Dimensions DSL Release Notes.