CitedEvidenceResearch APIs

Group by / facets

Return bucketed counts over any filterable field.

Pass group_by=field on any list endpoint to receive a facet-count response in place of the usual results array. group_bys=f1,f2 returns multiple facets at once.

Examples

  • GET/v1/oa/works?group_by=publication_year

    Works per year across all data.

  • GET/v1/oa/works?filter=authorships.institutions.id:I33213144&group_by=publication_year

    Works per year for a single institution.

  • GET/v1/oa/works?group_by=open_access.oa_status

    Distribution of OA statuses.

  • GET/v1/oa/works?group_by=type

    Work-type distribution.