Skip to main content
POST
/
api
/
openalex
/
authors
/
search
/openalex/authors/search
curl --request POST \
  --url https://api.anysite.io/api/openalex/authors/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "search": "<string>",
  "country_code": "US",
  "last_known_institution_id": "I27837315",
  "affiliation_institution_id": "<string>",
  "works_count": ">50",
  "cited_by_count": ">1000",
  "h_index": ">20"
}
'
[
  {
    "id": "<string>",
    "@type": "@openalex_author",
    "orcid": "<string>",
    "display_name": "",
    "display_name_alternatives": [],
    "works_count": 0,
    "cited_by_count": 0,
    "summary_stats": {
      "@type": "@openalex_summary_stats",
      "two_year_mean_citedness": 123,
      "h_index": 123,
      "i10_index": 123
    },
    "affiliations": [],
    "last_known_institutions": [],
    "topics": [],
    "topic_share": [],
    "x_concepts": [],
    "counts_by_year": [],
    "works_api_url": "<string>",
    "updated_at": "<string>",
    "created_at": "<string>"
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
count
integer
required

Number of authors to return

Required range: x >= 1
​
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
search
string | null

Search query across author names

​
country_code
string | null

ISO country code of the author's last-known institution

Example:

"US"

​
last_known_institution_id
string | null

OpenAlex id of the author's last-known institution

Example:

"I27837315"

​
affiliation_institution_id
string | null

OpenAlex id of any institution the author was affiliated with

​
works_count
string | null

Works-count filter, supports range operators

Example:

">50"

​
cited_by_count
string | null

Citation-count filter, supports range operators

Example:

">1000"

​
h_index
string | null

h-index filter, supports range operators

Example:

">20"

​
sort
enum<string> | null

Result ordering

Available options:
relevance_score:desc,
works_count:desc,
cited_by_count:desc,
summary_stats.h_index:desc

Response

Successful Response

​
id
string
required
​
@type
string
default:@openalex_author
​
orcid
string | null
​
display_name
string
default:""
​
display_name_alternatives
string[]
​
works_count
integer
default:0
​
cited_by_count
integer
default:0
​
summary_stats
OpenalexSummaryStats · object
​
affiliations
OpenalexAuthorAffiliation · object[]
​
last_known_institutions
OpenalexAuthorAffiliation · object[]
​
topics
OpenalexTopic · object[]
​
topic_share
OpenalexTopic · object[]
​
x_concepts
OpenalexAuthorConcept · object[]
​
counts_by_year
OpenalexCountByYear · object[]
​
works_api_url
string | null
​
updated_at
string | null
​
created_at
string | null