Get groups of entities
This returns a
metaobject with details about the query, an empty
resultsobject, and a
group_byobject with the groups you've asked for:
results: [ ],
So from this we can see that the majority of works (66,862,508 of them) are
closed, with another 10,499,470
bronze, and so forth.
Each group object in the
group_bylist contains three properties:
Value: an integer; the number of entities in the group.
keyis the same as
key_display_name; both are the raw value of the
group_byparameter for this group.
- For one group, both
- Dates like to_publication_date that only make sense for filtering because there isn't a single value that belongs to each entity.
- Wide-ranging numeric attributes like cited_by_count with high cardinality. Grouping on these values produces too many groups to be useful.
You can sort grouped by results using
key. The default is
You cannot page through grouped results using
page. However, you can use
per-pageto change the number of results returned. The default (and maximum) is 200 results. Changing
per-pageto a lower number will likely be faster.
filterparameters can be used at the same time. If you use both parameters, only the
filterwill be grouped and counted.
This gives you the overall count of open and closed Works in OpenAlex. About 68% are OA at the moment.
Combining this with the filter type:journal-article gives you the same count, but for journal articles only.
Journal articles are about 51% OA.
- Group journal articles with at least one author affiliated with the University of Florida by
You can export any group-by results to a CSV or Excel file by adding the
formatparameter with values
When exporting you will always receive up to 200 results.