Get Metrics

get /scisciDB/metrics

Flexible time-series query over a registered scisciDB metrics dataset.

Specify which dimensions to aggregate with group_by, and pass any declared filter or partition dimensions as extra query params to narrow the result. Comma-separated values are supported for multi-value filtering (IN clause).

Partition dimensions (e.g. metric_type) have safe defaults injected when omitted from both group_by and filters — prevents accidental cross-partition aggregation (e.g. summing total + has_abstract would double-count).

Examples: ?group_by=field,year&metric_type=total ?group_by=venue,year&field=Computer+Science&metric_type=total ?group_by=venue,metric_type&venue=Nature,Science&field=Computer+Science

Query Parameters

group_by string required

Comma-separated columns to GROUP BY, e.g. 'field,year'

dataset string

Registered dataset ID within scisciDB

start_year

end_year

exclude_nulls boolean

Exclude rows where any group_by column is NULL

top_n

Return only the top N groups by total count (non-time dimensions)

limit integer

curl -X GET http://localhost:8000/scisciDB/metrics \