Version: 11.1.1

Persons

Search and retrieve persons — authors and contributors involved in research products.

Base URL

https://api-beta.openaire.eu/graph/v4/persons

Search for a person by name:

Parameter	Type	Default	Description
`filter`	string	—	Comma-separated `field:value` predicates (see filter syntax)
`search`	string	—	Full-text keyword search across the person's default fields
`sort`	string	`relevance:desc`	Comma-chained `field:direction` directives (see sorting)
`select`	string	(full object)	Comma-separated response fields to return (see sparse fieldsets)
`page`	int	1	Page number (see paging)
`page_size`	int	10	Results per page, range 1–100
`cursor`	string	—	Cursor-based pagination (see cursor paging)
`mailto`	string	—	Contact email for the polite pool / higher-rate tier

note

The facets and group_by parameters are not available for persons — see Aggregations.

The response is an object with a header and a results array:

{
  "header": {
    "numFound": 21000000,
    "maxScore": 1,
    "queryTime": 12,
    "page": 1,
    "pageSize": 10
  },
  "results": [
    ...
  ]
}

The results array contains Person objects.