The Dimensions Search Language

Version cris-3.1.0

Welcome to the documentation of the Dimensions Search Language (DSL) project. The DSL enables users to perform analytics on the Dimensions database.

This documentation contains high-level information about the project and its development, as well as the language’s features and usage. Please see the APIs Homepage for more details about available API packages and subscriptions.

Note

The Dimensions CRIS API is subscription-only, so your Dimensions account needs to be activated for this service and subject to restrictions on use. Please send an email to supportapi@dimensions.ai if you have any questions.

Contents:

• Getting Started Checklist
• A Tour of the DSL
  • A simple query
  • The anatomy of a query
  • search for source documents
  • return information about documents
• Query Syntax
  • Basic query structure
  • Full-text Searching
  • Field Searching
  • Searching for Researchers
  • Searching using concepts
  • Returning results
• Returning facets
  • Function: citations_per_year
  • Function: funding_per_year
  • Formal language specification
• Functions Syntax
  • Basic functions structure
  • Function: classify
  • Function: extract_affiliations
  • Function: extract_concepts
  • Function: extract_grants
• Data Sources
  • Publications
  • Grants
  • Patents
  • Clinical Trials
  • Policy Documents
  • Datasets
  • Source Titles
  • Reports
  • Researchers
  • Organizations
  • Auxiliary Entities
  • Literal Field Types
  • Metadata API
• Example Queries and Results
  • Minimal valid query
  • Searching records
  • Returning records
  • Naming/grouping results
  • Limiting/paging results
  • Indicators Aggregations
• API Access
  • Getting an API Key
  • Querying the API
  • CURL Example
  • Python Example
• Glossary
• Reasonable Use
• Release Notes and Deprecations
  • Versions History
  • Deprecations History
• Frequently Asked Questions
  • 1. API Access & Support
  • 2. Queries and Errors
  • 3. Data Model