Citation momentum of a paper (accelerating / steady / declining) API

Derives a citation-velocity verdict from OpenAlex per-year counts: compares the recent two-year window vs the prior window (excluding the partial current year), with FWCI and field-normalized percentile. Answers 'is this paper still gaining citations or fading?', 'is it a top-1% paper in its field?'.

Price$0.01per request

MethodPOST

Route/v1/science/scholar-citation-trend

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache86400s public

sciencescholarcitationstrendmomentumopenalexfwcipercentile

API URLhttps://x402.hexl.dev/v1/science/scholar-citation-trend

Integration docs

Example request

{
  "doi": "10.1038/nature12373"
}

Example response

{
  "doi": "10.1038/nature12373",
  "title": "Nanometre-scale thermometry in a living cell",
  "citedByCount": 1953,
  "fwci": 54.1687,
  "percentile": {
    "value": 0.99966438,
    "topOnePercent": true,
    "topTenPercent": true
  },
  "trend": "steady",
  "recentYearAvg": 168,
  "priorYearAvg": 183,
  "changePct": -8.2,
  "peakYear": 2021,
  "countsByYear": [
    {
      "year": 2025,
      "cited_by_count": 195
    },
    {
      "year": 2024,
      "cited_by_count": 141
    },
    {
      "year": 2023,
      "cited_by_count": 187
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "doi"
  ],
  "properties": {
    "doi": {
      "type": "string"
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}