Elements Live Subjects API

The Subjects API from Elements Live — 5 operation(s) for subjects.

GitHub OpenAPI

Operations 5

GET /subjects/search Resolve a free-text query to subject_type/subject_id #
GET /subjects/{subject_type}/{subject_id} RI/RIS/HRI/paper_count for one topic or keyword (Personal+ key) #
GET /subjects/{subject_type}/{subject_id}/elements Elements most associated with this subject: measured RIS in the subject plus… #
GET /subjects/{subject_type}/{subject_id}/history Full history for one topic or keyword (Personal+ key) #
GET /subjects/{subject_type}/{subject_id}/papers Top papers driving one topic's RI (Personal+ key). Capped at 100, no pagination. #

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/elements-live-com:elements-live-com-subjects-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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

elements-live-com-subjects-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  description: Research-intensity (RI/RIS/HRI) data for 118 chemical elements and thousands of research topics/keywords, derived from a continuously updated scientific-literature corpus. Current element scores need no key; element history and topic search are free with any API key; topic/keyword data and paper lists need a Personal+ key, Lab a Professional+ key. Without a key, every keyed operation can be paid per call in USDC on Base or Solana with x402 (see each operation's x-payment-info, and https://www.elements-live.com/.well-known/x402).
  title: Elements Live Subjects API
  version: 1.0.0
servers:
- url: https://www.elements-live.com/v1
security:
- bearerAuth: []
tags:
- name: Subjects
paths:
  /subjects/search:
    get:
      responses:
        '200':
          content:
            application/json:
              example:
                count: 1
                results:
                - canonical_url: https://www.elements-live.com/subjects/keyword/lithium-niobate
                  display_name: lithium niobate
                  kind: material
                  subject_id: lithium-niobate
                  subject_type: keyword
              schema:
                properties:
                  count:
                    type: integer
                  results:
                    items:
                      properties:
                        canonical_url:
                          type: string
                        subject_id:
                          type: string
                        subject_type:
                          type: string
                      required:
                      - subject_type
                      - subject_id
                      - display_name
                      - kind
                      - canonical_url
                      type: object
                    type: array
                required:
                - count
                - results
                type: object
          description: OK
      summary: Resolve a free-text query to subject_type/subject_id
      x-payment-info:
        asset: USDC
        networks:
        - eip155:8453
        - solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
        price_usd: '0.01'
        protocols:
        - x402
      tags:
      - Subjects
      operationId: getSubjectsSearch
      x-operation-id-source: derived
  /subjects/{subject_type}/{subject_id}:
    get:
      responses:
        '200':
          content:
            application/json:
              example:
                as_of: null
                canonical_url: https://www.elements-live.com/subjects/keyword/lithium-niobate
                entity:
                  id: lithium-niobate
                  name: lithium niobate
                  type: keyword
                license: Derived scores are Elements Live's own work product. …
                methodology_url: https://www.elements-live.com/methodology
                metrics:
                  hri: 0.9096
                  paper_count: 16470
                  ri: 3750.4604
                  ris: 0.1368
                notes:
                  hri: HRI is this entity's activity relative to its own all-time peak. …
                  recency: The most recent ~6 months of any time series are systematically …
                  ris: 'RIS is log-normally distributed across entities: compare two different …'
              schema:
                properties:
                  canonical_url:
                    type: string
                  entity:
                    properties:
                      id:
                        type: string
                      name:
                        type: string
                      type:
                        type: string
                    required:
                    - type
                    - id
                    - name
                    type: object
                  license:
                    type: string
                  methodology_url:
                    type: string
                  metrics:
                    required:
                    - ri
                    - ris
                    - hri
                    - paper_count
                    type: object
                  notes:
                    type: object
                required:
                - entity
                - metrics
                - as_of
                - notes
                - canonical_url
                - methodology_url
                - license
                type: object
          description: OK
      summary: RI/RIS/HRI/paper_count for one topic or keyword (Personal+ key)
      x-payment-info:
        asset: USDC
        networks:
        - eip155:8453
        - solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
        price_usd: '0.01'
        protocols:
        - x402
      tags:
      - Subjects
      operationId: getSubjectsBySubjectTypeBySubjectId
      x-operation-id-source: derived
  /subjects/{subject_type}/{subject_id}/elements:
    get:
      responses:
        '200':
          content:
            application/json:
              example:
                elements:
                - canonical_url: https://www.elements-live.com/elements/Nb
                  fold_target: false
                  hri_in_element: 1.0
                  name: Niobium
                  ris_in_element: 0.8394
                  symbol: Nb
                - canonical_url: https://www.elements-live.com/elements/Li
                  fold_target: true
                  hri_in_element: 0.3012
                  name: Lithium
                  ris_in_element: 0.4886
                  symbol: Li
                subject_id: lithium-niobate
                subject_type: keyword
              schema:
                properties:
                  elements:
                    items:
                      properties:
                        canonical_url:
                          type: string
                        fold_target:
                          type: boolean
                        name:
                          type: string
                        symbol:
                          type: string
                      required:
                      - symbol
                      - name
                      - ris_in_element
                      - hri_in_element
                      - fold_target
                      - canonical_url
                      type: object
                    type: array
                  subject_id:
                    type: string
                  subject_type:
                    type: string
                required:
                - subject_type
                - subject_id
                - elements
                type: object
          description: OK
      summary: 'Elements most associated with this subject: measured RIS in the subject plus…'
      x-payment-info:
        asset: USDC
        networks:
        - eip155:8453
        - solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
        price_usd: '0.10'
        protocols:
        - x402
      tags:
      - Subjects
      operationId: getSubjectsBySubjectTypeBySubjectIdElements
      x-operation-id-source: derived
  /subjects/{subject_type}/{subject_id}/history:
    get:
      responses:
        '200':
          content:
            application/json:
              example:
                canonical_url: https://www.elements-live.com/subjects/keyword/lithium-niobate
                entity:
                  id: lithium-niobate
                  name: lithium niobate
                  type: keyword
                labels:
                - '2024'
                - '2025'
                - '2026'
                metrics:
                  hri:
                  - 0.8848
                  - 0.922
                  - 0.9096
                  ris:
                  - 0.1273
                  - 0.131
                  - 0.1368
                notes:
                  hri: HRI is this entity's activity relative to its own all-time peak. …
                  recency: The most recent ~6 months of any time series are systematically …
                  ris: 'RIS is log-normally distributed across entities: compare two different …'
                resolution: yearly
              schema:
                properties:
                  canonical_url:
                    type: string
                  entity:
                    properties:
                      id:
                        type: string
                      name:
                        type: string
                      type:
                        type: string
                    required:
                    - type
                    - id
                    - name
                    type: object
                  labels:
                    items:
                      type: string
                    type: array
                  metrics:
                    properties:
                      hri:
                        type: array
                      ris:
                        type: array
                    required:
                    - ris
                    - hri
                    type: object
                  notes:
                    type: object
                  resolution:
                    type: string
                required:
                - entity
                - resolution
                - labels
                - metrics
                - notes
                - canonical_url
                type: object
          description: OK
      summary: Full history for one topic or keyword (Personal+ key)
      x-payment-info:
        asset: USDC
        networks:
        - eip155:8453
        - solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
        price_usd: '0.10'
        protocols:
        - x402
      tags:
      - Subjects
      operationId: getSubjectsBySubjectTypeBySubjectIdHistory
      x-operation-id-source: derived
  /subjects/{subject_type}/{subject_id}/papers:
    get:
      responses:
        '200':
          content:
            application/json:
              example:
                canonical_url: https://www.elements-live.com/subjects/keyword/lithium-niobate
                count: 1
                entity:
                  id: lithium-niobate
                  name: lithium niobate
                  type: keyword
                notes:
                  coverage: Only the top 100 papers per entity are ranked and available; …
                  curation: 'Which papers appear, and in what order, is Elements Live''s curation: …'
                  ranking: '`rank` is the entity''s impact ranking (impact_score: …). Do NOT re-sort by …'
                results:
                - citation_percentile: 100.0
                  citations: 678
                  cluster: Electrical and Electronic Engineering
                  doi: 10.1126/science.abj4396
                  impact_score: 4.5775
                  rank: 1
                  ris_contribution: 0.0
                  title: 'Lithium niobate photonics: Unlocking the electromagnetic spectrum'
                  url: https://doi.org/10.1126/science.abj4396
                  venue: null
                  year: 2023
                sort: impact
                total_papers: 16470
                total_ranked: 100
              schema:
                properties:
                  canonical_url:
                    type: string
                  count:
                    type: integer
                  entity:
                    properties:
                      id:
                        type: string
                      name:
                        type: string
                      type:
                        type: string
                    required:
                    - type
                    - id
                    - name
                    type: object
                  notes:
                    type: object
                  results:
                    items:
                      required:
                      - rank
                      - doi
                      - title
                      - venue
                      - year
                      - citations
                      - impact_score
                      - citation_percentile
                      - cluster
                      - url
                      - ris_contribution
                      type: object
                    type: array
                  sort:
                    type: string
                  total_ranked:
                    type: integer
                required:
                - entity
                - sort
                - count
                - total_ranked
                - results
                - notes
                - canonical_url
                - total_papers
                type: object
          description: OK
      summary: Top papers driving one topic's RI (Personal+ key). Capped at 100, no pagination.
      x-payment-info:
        asset: USDC
        networks:
        - eip155:8453
        - solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
        price_usd: '0.02'
        price_usd_over_20_papers: '0.10'
        protocols:
        - x402
      tags:
      - Subjects
      operationId: getSubjectsBySubjectTypeBySubjectIdPapers
      x-operation-id-source: derived
components:
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http