PlumX Metrics
plumx_metricsRetrieve native PlumX metrics for a publication or artifact by DOI, PMID, or other identifier and return Elsevier JSON with categories, counts, and sources.
Instructions
Retrieve native PlumX metrics for one publication or artifact by identifier. Returns the original Elsevier JSON, including metric categories, count types and sources. Requires active Scopus access. HTTP 404 can mean that no metrics are available or that the identifier is unknown.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"idType": "<idType>",
"idValue": "<idValue>"
},
"name": "plumx_metrics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reqId | No | Caller-supplied request identifier for tracing this request with Elsevier support. | |
| idType | Yes | Identifier namespace used to locate the publication or artifact in PlumX. | |
| idValue | Yes | Identifier in the selected namespace, e.g. 10.1103/physrevlett.116.061102 for doi. Supply the original value without URL encoding; a lone . or .. is not allowed. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id_type | Yes | Identifier namespace returned by PlumX. | |
| id_value | Yes | Identifier value returned by PlumX. | |
| count_categories | No | Available PlumX metric categories and their counts; may be absent or null. |