Clarivate Feed API

The feed API from Clarivate — 4 operation(s) for feed.

Documentation GitHub OpenAPI

Operations 4

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /ric/download/v1/requestPackage Request a content package for download · Request Package #

Ask an LLM

“How do I start preparing a bulk download package of a content set?”

“Can I split the prepared package into multiple files or choose its format?”

Tell an agent

Request a download package of content set {contentSet} using preset {preset}.

Prepare a {format} package of {contentSet} with preset {preset}.

GET /ric/download/v1/checkPackageStatus Check a download package's status · Check Package Status #

Ask an LLM

“How do I know when my requested content package is ready?”

“Is my feed package still being prepared?”

Tell an agent

Check the status of package {token}.

Tell me whether download package {token} has finished preparing.

GET /ric/download/v1/downloadPackage Download a prepared content package · Download Package #

Ask an LLM

“How do I download the result file once my content package is ready?”

“Can I fetch a finished feed package using its token?”

Tell an agent

Download package {token}.

Fetch the finished result file for feed token {token}.

GET /ric/download/v1/info List my content subscriptions · Get Subscriptions Info #

Ask an LLM

“Which content sets am I subscribed to in the feed API?”

“What content subscriptions does my account have for bulk downloads?”

Tell an agent

Show my content subscriptions.

List the content sets my account can download.

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/clarivate:clarivate-feed-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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: RIC Feed API
  version: 0.2.649dde3-18
servers:
- url: https://api.clarivate.com
security:
- key: []
tags:
- name: Feed
paths:
  /ric/download/v1/requestPackage:
    post:
      tags:
      - Feed
      summary: Request Package
      description: Start package preparation
      operationId: request_package_ric_download_v1_requestPackage_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RequestPackageInput'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestPackageResult'
        '400':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Authorization Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Unexpected Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /ric/download/v1/checkPackageStatus:
    get:
      tags:
      - Feed
      summary: Check Package Status
      description: Check package status
      operationId: check_package_status_ric_download_v1_checkPackageStatus_get
      parameters:
      - name: token
        in: query
        required: true
        schema:
          type: string
          description: Unique identifier in uuid4 format representing a data feed package that has been requested.
          title: Token
        description: Unique identifier in uuid4 format representing a data feed package that has been requested.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckPackageStatusResult'
        '400':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Authorization Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Unexpected Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /ric/download/v1/downloadPackage:
    get:
      tags:
      - Feed
      summary: Download Package
      description: Download result package
      operationId: download_package_ric_download_v1_downloadPackage_get
      parameters:
      - name: token
        in: query
        required: true
        schema:
          type: string
          description: Unique identifier in uuid4 format representing a generated file.
          title: Token
        description: Unique identifier in uuid4 format representing a generated file.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '400':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Authorization Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Unexpected Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /ric/download/v1/info:
    get:
      tags:
      - Feed
      summary: Get Subscriptions Info
      description: Get content subscriptions information
      operationId: get_subscriptions_info_ric_download_v1_info_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubscriptionsInfoResult'
        '400':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Authorization Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Unexpected Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    Error:
      properties:
        code:
          type: integer
          title: Code
        message:
          type: string
          title: Message
        location:
          anyOf:
          - items:
              anyOf:
              - type: string
              - type: integer
            type: array
          - type: 'null'
          title: Location
      type: object
      required:
      - code
      - message
      title: Error
    FilterGroup:
      items:
        anyOf:
        - $ref: '#/components/schemas/Filter'
        - $ref: '#/components/schemas/ConjunctionEnum'
        - $ref: '#/components/schemas/FilterGroup'
      type: array
      minLength: 0
      title: FilterGroup
    StatusEnum:
      type: string
      enum:
      - pending
      - running
      - done
      - failed
      - outdated
      - done-no-match
      title: StatusEnum
    CheckPackageStatusResultFile:
      properties:
        token:
          type: string
          format: uuid4
          title: Token
          description: Unique identifier in uuid4 format representing a generated file.
        tokenUsed:
          type: boolean
          title: Tokenused
          description: Flag which shows if the file has been downloaded already at least once.
        fileName:
          anyOf:
          - type: string
          - type: 'null'
          title: Filename
          description: File name.
        fileType:
          anyOf:
          - $ref: '#/components/schemas/FileTypeEnum'
          - type: 'null'
          description: File output format (E.g., JSON, parquet).
        fileSize:
          anyOf:
          - type: string
          - type: 'null'
          title: Filesize
          description: Size of the file in Kilo Bytes.
        checksumName:
          anyOf:
          - type: string
          - type: 'null'
          title: Checksumname
          description: Checksum name.
        checksum:
          anyOf:
          - type: string
          - type: 'null'
          title: Checksum
          description: Checksum.
        numberOfRecords:
          anyOf:
          - type: integer
          - type: 'null'
          title: Numberofrecords
          description: Number of records.
      type: object
      required:
      - token
      - tokenUsed
      - fileName
      - fileType
      - fileSize
      - checksumName
      - checksum
      - numberOfRecords
      title: CheckPackageStatusResultFile
    SubscriptionsInfoResult:
      properties:
        subscriptions:
          items:
            $ref: '#/components/schemas/ContentSubscriptionResponse'
          type: array
          title: Subscriptions
          description: List of subscribed datasets
      type: object
      required:
      - subscriptions
      title: SubscriptionsInfoResult
    MaxInternalChangeNumber:
      properties:
        contentSet:
          type: string
          title: Contentset
          description: Content set/data set name (value could be "custom").
        preset:
          type: string
          title: Preset
          description: Preset of the dataset (E.g., Standard, Full, or the name of the custom dataset).
        value:
          type: integer
          title: Value
          description: Maximal Internal Change Number value.
      type: object
      required:
      - contentSet
      - preset
      - value
      title: MaxInternalChangeNumber
    RequestPackageInput:
      properties:
        requestId:
          anyOf:
          - type: string
            maxLength: 40
            minLength: 1
          - type: 'null'
          title: Requestid
          description: Request Id
        contentSet:
          type: string
          title: Contentset
          description: Name of the subscribed content set/data set.
        preset:
          type: string
          title: Preset
          description: Name of the preset (E.g., Standard, Full, or the name of the custom dataset).
        format:
          allOf:
          - $ref: '#/components/schemas/Format'
          description: File output format (E.g., JSON, parquet). Default value is JSON.
          default: json
        splitFiles:
          type: boolean
          title: Splitfiles
          description: true or false (default). Return big files in chunks of 1GB each.
          default: false
        filters:
          anyOf:
          - $ref: '#/components/schemas/FilterGroup'
          - type: 'null'
          description: List of filtering options that can be passed
      additionalProperties: false
      type: object
      required:
      - contentSet
      - preset
      title: RequestPackageInput
    Format:
      type: string
      enum:
      - json
      - parquet
      title: Format
    Filter:
      properties:
        field:
          type: string
          title: Field
          description: Name of the filter. Only "internalChangeNumber" is currently supported.
        op:
          allOf:
          - $ref: '#/components/schemas/OperationEnum'
          description: Filter's operator. Possible values are 'gt' (greater than), 'lt' (lower than).
        value:
          title: Value
          description: Filter's value corresponding to the maxInternalChangeNumber field value returned from a previous call by the checkPackageStatus endpoint.
      additionalProperties: false
      type: object
      required:
      - field
      - op
      - value
      title: Filter
    CheckPackageStatusResult:
      properties:
        status:
          allOf:
          - $ref: '#/components/schemas/StatusEnum'
          description: 'Status of the package preparation.values can be: pending, running, done-no-match or done.'
        dateCompleted:
          anyOf:
          - type: string
          - type: 'null'
          title: Datecompleted
          description: Date-time the package preparation completed.
        maxInternalChangeNumber:
          anyOf:
          - items:
              $ref: '#/components/schemas/MaxInternalChangeNumber'
            type: array
          - type: 'null'
          title: Maxinternalchangenumber
          description: Maximal value of the internal Change Number field.
        files:
          items:
            $ref: '#/components/schemas/CheckPackageStatusResultFile'
          type: array
          title: Files
          description: List of files that can be downloaded.
      type: object
      required:
      - status
      - dateCompleted
      - maxInternalChangeNumber
      - files
      title: CheckPackageStatusResult
    FileTypeEnum:
      type: string
      enum:
      - json
      - parquet
      - resources
      - schema
      title: FileTypeEnum
    RequestPackageResult:
      properties:
        token:
          type: string
          format: uuid4
          title: Token
          description: Unique identifier in uuid4 format representing a data feed package that has been requested.
      type: object
      required:
      - token
      title: RequestPackageResult
    ErrorResponse:
      properties:
        errors:
          items:
            $ref: '#/components/schemas/Error'
          type: array
          title: Errors
      type: object
      required:
      - errors
      title: ErrorResponse
      description: 'Customize Validation Error

        https://github.com/tiangolo/fastapi/issues/1376'
    ContentSubscriptionResponse:
      properties:
        name:
          type: string
          title: Name
          description: Name of the subscribed dataset
        contentSet:
          type: string
          title: Contentset
          description: Name of the content set parameter to be passed in the API calls
        preset:
          type: string
          title: Preset
          description: Name of the preset parameter to be passed in the API calls
        description:
          type: string
          title: Description
          description: 'Description of the subscribed dataset '
      type: object
      required:
      - name
      - contentSet
      - preset
      - description
      title: ContentSubscriptionResponse
    OperationEnum:
      type: string
      enum:
      - eq
      - lt
      - gt
      - le
      - ge
      - ne
      - in
      - is
      - like
      - any of
      - not in
      - is not
      - not like
      title: OperationEnum
    ConjunctionEnum:
      type: string
      enum:
      - OR
      - AND
      title: ConjunctionEnum
  securitySchemes:
    key:
      type: apiKey
      in: header
      name: X-ApiKey
x-provenance:
  method: harvested
  publisher: Clarivate
  source: https://developer.clarivate.com/apis/ric-download-api/swagger
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)

Clarivate Feed API

Operations 4

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification