Skip to main content
POST
/
api
/
openalex
/
institutions
/openalex/institutions
curl --request POST \
  --url https://api.anysite.io/api/openalex/institutions \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "institution": "<string>",
  "timeout": 300
}
'
[
  {
    "id": "<string>",
    "@type": "@openalex_institution",
    "ror": "<string>",
    "display_name": "",
    "display_name_acronyms": [],
    "display_name_alternatives": [],
    "country_code": "<string>",
    "type": "<string>",
    "status": "<string>",
    "homepage_url": "<string>",
    "image": "<string>",
    "works_count": 0,
    "cited_by_count": 0,
    "summary_stats": {
      "@type": "@openalex_summary_stats",
      "two_year_mean_citedness": 123,
      "h_index": 123,
      "i10_index": 123
    },
    "geo": {
      "@type": "@openalex_institution_geo",
      "city": "<string>",
      "region": "<string>",
      "country_code": "<string>",
      "country": "<string>",
      "latitude": 123,
      "longitude": 123
    },
    "associated_institutions": [],
    "topics": [],
    "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
institution
string
required

Institution identifier: OpenAlex id (I...) or a prefixed ROR (ror:)

Minimum string length: 1
Examples:

"I27837315"

"ror:00jmfr291"

timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500

Response

Successful Response

id
string
required
@type
string
default:@openalex_institution
ror
string | null
display_name
string
default:""
display_name_acronyms
string[]
display_name_alternatives
string[]
country_code
string | null
type
string | null
status
string | null
homepage_url
string | null
image
string | null
works_count
integer
default:0
cited_by_count
integer
default:0
summary_stats
OpenalexSummaryStats · object
geo
OpenalexInstitutionGeo · object
associated_institutions
OpenalexAssociatedInstitution · object[]
topics
OpenalexTopic · object[]
counts_by_year
OpenalexCountByYear · object[]
works_api_url
string | null
updated_at
string | null
created_at
string | null