Semantic Scholar Release Data API

The Release Data API from Semantic Scholar — 3 operation(s) for release data.

Operations 3

GET /release/ List of Available Releases #
GET /release/{release_id} List of Datasets in a Release #
GET /release/{release_id}/dataset/{dataset_name} Download Links for a Dataset #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/semantic-scholar:semantic-scholar-release-data-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

semantic-scholar-release-data-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: S2AG Datasets Release Data API
  version: '1.0'
  description: 'Download full-corpus datasets from the Semantic Scholar Academic Graph (S2AG)


    Some python demonstrating usage of the datasets API:


    r1 = requests.get(''https://api.semanticscholar.org/datasets/v1/release'').json()

    print(r1[-3:])

    [''2023-03-14'', ''2023-03-21'', ''2023-03-28'']


    r2 = requests.get(''https://api.semanticscholar.org/datasets/v1/release/latest'').json()

    print(r2[''release_id''])

    2023-03-28


    print(json.dumps(r2[''datasets''][0], indent=2))

    {

    "name": "abstracts",

    "description": "Paper abstract…'
servers:
- url: https://api.semanticscholar.org/datasets/v1
tags:
- name: Release Data
paths:
  /release/:
    get:
      summary: List of Available Releases
      operationId: get_releases
      tags:
      - Release Data
      description: Releases are identified by a date stamp such as "2023-08-01". Each release contains full data for each dataset.
      responses:
        '200':
          description: List of Available Releases
          content:
            application/json:
              schema:
                type: array
                items:
                  type: string
                  description: Release ids in the form of date stamps
                  example: '2022-01-17'
  /release/{release_id}:
    get:
      summary: List of Datasets in a Release
      operationId: get_release
      tags:
      - Release Data
      description: Metadata describing a particular release, including a list of datasets available.
      responses:
        '200':
          description: Contents of the release with the given ID
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Release%20Metadata'
  /release/{release_id}/dataset/{dataset_name}:
    get:
      summary: Download Links for a Dataset
      operationId: get_dataset
      tags:
      - Release Data
      description: 'Datasets are partitioned and stored on S3. Clients can retrieve them by requesting this list

        of pre-signed download urls and fetching all the partitions.'
      responses:
        '200':
          description: Description and download links for the given dataset within the given release
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Dataset%20Metadata'