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.
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: Live Elements API
version: 1.0.0
servers:
- url: https://www.elements-live.com/v1
security:
- bearerAuth: []
tags:
- name: Elements
paths:
/elements:
get:
security:
- {}
- bearerAuth: []
summary: List RIS for all 118 elements (no key needed; HRI with a Personal+ key)
tags:
- Elements
operationId: getElements
x-operation-id-source: derived
/elements/{symbol}:
get:
security:
- {}
- bearerAuth: []
summary: RIS for one element (no key needed; HRI with a Personal+ key)
tags:
- Elements
operationId: getElementsBySymbol
x-operation-id-source: derived
/elements/{symbol}/history:
get:
responses:
'200':
content:
application/json:
example:
canonical_url: https://www.elements-live.com/elements/Fe
entity:
id: Fe
name: Iron
type: element
labels:
- '2024'
- '2025'
- '2026'
metrics:
hri:
- 0.5563
- 0.534
- 0.5204
ris:
- 0.2701
- 0.2624
- 0.2631
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 RIS history for one element, HRI with a Personal+ key.
x-payment-info:
asset: USDC
networks:
- eip155:8453
- solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
price_usd: '0.05'
protocols:
- x402
tags:
- Elements
operationId: getElementsBySymbolHistory
x-operation-id-source: derived
/elements/{symbol}/papers:
get:
responses:
'200':
content:
application/json:
example:
canonical_url: https://www.elements-live.com/elements/Fe
count: 1
entity:
id: Fe
name: Iron
type: element
keyword: null
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: 586
cluster: Mechanical Engineering
doi: 10.1201/9781003099949-3
impact_score: 5.236
rank: 8
ris_contribution: 2.4752
title: Ironmaking and Steelmaking
url: https://doi.org/10.1201/9781003099949-3
venue: null
year: 2024
sort: impact
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
- keyword
type: object
description: OK
summary: Top papers driving one element's RI (Personal+ key).
x-payment-info:
asset: USDC
networks:
- eip155:8453
- solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
price_usd: '0.02'
price_usd_over_20_papers: '0.10'
protocols:
- x402
tags:
- Elements
operationId: getElementsBySymbolPapers
x-operation-id-source: derived
components:
securitySchemes:
bearerAuth:
scheme: bearer
type: http