Institutions
List institutions
Query and list academic institutions with filtering, sorting, and pagination.
GET
/
institutions
curl -X GET "https://api.hexagraph.in/institutions?filter=type:facility&sort=outputs_count:desc&per_page=25"
fetch("https://api.hexagraph.in/institutions?filter=type:facility&sort=outputs_count:desc&per_page=25")
.then(response => response.json())
.then(data => console.log(data));
import requests
response = requests.get("https://api.hexagraph.in/institutions", params={"filter": "type:facility", "sort": "outputs_count:desc", "per_page": 25})
print(response.json())
{
"meta": {
"count": 134448,
"page": 1,
"per_page": 25
},
"results": [
{
"id": "HX_I4210108322",
"ror": "https://ror.org/01t3wyv61",
"name": "National Institute for Fusion Science",
"country": {
"code": "JP",
"name": "Japan"
},
"type": "facility",
"homepage_url": "https://www.nifs.ac.jp",
"image_url": null,
"image_thumbnail_url": null,
"display_name_acronyms": [
"NIFS"
],
"display_name_alternatives": [
"Kakuyugo Kagaku Kenkyujo",
"Kakuyugou Kagaku Kenkyuujo",
"Kakuyūgō Kagaku Kenkyūjo",
"NINS National Institute for Fusion Science",
"National Institute for Fusion Science",
"National Institutes of Natural Sciences National Institute for Fusion Science",
"かくゆうごうかがくけんきゅうじょ",
"カクユウゴウカガクケンキュウジョ",
"核融合科学研究所"
],
"repositories": [
{
"id": "HX_S4306401138",
"name": "National Institute for Fusion Science Repository (National Institute for Fusion Science)"
}
],
"outputs_count": 40567916,
"cited_by_count": 2350640,
"summary_stats": {
"2yr_mean_citedness": 0.000029117814157264747,
"h_index": 194,
"i10_index": 18840
},
"associated_institutions": [
{
"id": "HX_I199525922",
"name": "National Institutes of Natural Sciences",
"relationship": "parent"
}
],
"counts_by_year": [
{
"year": 2026,
"outputs_count": 11617444,
"oa_outputs_count": 11617410,
"cited_by_count": 49
},
{
"year": 2025,
"outputs_count": 18940305,
"oa_outputs_count": 18940235,
"cited_by_count": 442
},
{
"year": 2024,
"outputs_count": 10000445,
"oa_outputs_count": 10000376,
"cited_by_count": 1130
}
],
"roles": [
{
"role": "funder",
"id": "HX_F4320338091",
"outputs_count": 2266
},
{
"role": "institution",
"id": "HX_I4210108322",
"outputs_count": 40567916
}
],
"geo": {
"city": "Toki",
"geonames_city_id": "1850207",
"region": null,
"country_code": "JP",
"country": "Japan",
"latitude": 35.349998474121094,
"longitude": 137.18333435058594
},
"international": {},
"updated_date": "2026-08-05T05:59:45",
"created_date": "2022-02-02T04:48:36",
"topics": [
{
"id": "HX_T12157",
"name": "Geochemistry and Geologic Mapping"
},
{
"id": "HX_T13067",
"name": "Geological Modeling and Analysis"
},
{
"id": "HX_T10346",
"name": "Magnetic confinement fusion research"
}
]
}
]
}
{
"statusCode": 400,
"message": "Bad Request - Invalid query parameters",
"error": "Bad Request"
}
{
"statusCode": 429,
"message": "Rate limit exceeded. Maximum 30 requests per minute.",
"error": "Too Many Requests"
}
Retrieves a paginated list of academic institutions with filtering and sorting capabilities.
Query Parameters
integer
default:"1"
Page number for pagination. Default is
1.integer
default:"25"
Results per page. Allowed values:
10, 25, 50, 100.string
Filter expression (e.g.
type:education, country_code:US).string
Sorting parameter (e.g.
outputs_count:desc, cited_by_count:desc).Response Fields
object
required
array
required
Array of institution records.
Show results item attributes
Show results item attributes
string
Institution ID (
HX_I...).string
Research Organization Registry (ROR) URL.
string
Institution display name.
object
string
Institution classification (
facility, education, etc.).string
Homepage URL.
string
Image logo URL.
string
Thumbnail image URL.
array
List of acronyms.
array
List of alternative names.
array
integer
Total outputs count.
integer
Total citations count.
object
array
array
array
object
object
International metadata object.
string
ISO update date string.
string
ISO creation date string.
curl -X GET "https://api.hexagraph.in/institutions?filter=type:facility&sort=outputs_count:desc&per_page=25"
fetch("https://api.hexagraph.in/institutions?filter=type:facility&sort=outputs_count:desc&per_page=25")
.then(response => response.json())
.then(data => console.log(data));
import requests
response = requests.get("https://api.hexagraph.in/institutions", params={"filter": "type:facility", "sort": "outputs_count:desc", "per_page": 25})
print(response.json())
{
"meta": {
"count": 134448,
"page": 1,
"per_page": 25
},
"results": [
{
"id": "HX_I4210108322",
"ror": "https://ror.org/01t3wyv61",
"name": "National Institute for Fusion Science",
"country": {
"code": "JP",
"name": "Japan"
},
"type": "facility",
"homepage_url": "https://www.nifs.ac.jp",
"image_url": null,
"image_thumbnail_url": null,
"display_name_acronyms": [
"NIFS"
],
"display_name_alternatives": [
"Kakuyugo Kagaku Kenkyujo",
"Kakuyugou Kagaku Kenkyuujo",
"Kakuyūgō Kagaku Kenkyūjo",
"NINS National Institute for Fusion Science",
"National Institute for Fusion Science",
"National Institutes of Natural Sciences National Institute for Fusion Science",
"かくゆうごうかがくけんきゅうじょ",
"カクユウゴウカガクケンキュウジョ",
"核融合科学研究所"
],
"repositories": [
{
"id": "HX_S4306401138",
"name": "National Institute for Fusion Science Repository (National Institute for Fusion Science)"
}
],
"outputs_count": 40567916,
"cited_by_count": 2350640,
"summary_stats": {
"2yr_mean_citedness": 0.000029117814157264747,
"h_index": 194,
"i10_index": 18840
},
"associated_institutions": [
{
"id": "HX_I199525922",
"name": "National Institutes of Natural Sciences",
"relationship": "parent"
}
],
"counts_by_year": [
{
"year": 2026,
"outputs_count": 11617444,
"oa_outputs_count": 11617410,
"cited_by_count": 49
},
{
"year": 2025,
"outputs_count": 18940305,
"oa_outputs_count": 18940235,
"cited_by_count": 442
},
{
"year": 2024,
"outputs_count": 10000445,
"oa_outputs_count": 10000376,
"cited_by_count": 1130
}
],
"roles": [
{
"role": "funder",
"id": "HX_F4320338091",
"outputs_count": 2266
},
{
"role": "institution",
"id": "HX_I4210108322",
"outputs_count": 40567916
}
],
"geo": {
"city": "Toki",
"geonames_city_id": "1850207",
"region": null,
"country_code": "JP",
"country": "Japan",
"latitude": 35.349998474121094,
"longitude": 137.18333435058594
},
"international": {},
"updated_date": "2026-08-05T05:59:45",
"created_date": "2022-02-02T04:48:36",
"topics": [
{
"id": "HX_T12157",
"name": "Geochemistry and Geologic Mapping"
},
{
"id": "HX_T13067",
"name": "Geological Modeling and Analysis"
},
{
"id": "HX_T10346",
"name": "Magnetic confinement fusion research"
}
]
}
]
}
{
"statusCode": 400,
"message": "Bad Request - Invalid query parameters",
"error": "Bad Request"
}
{
"statusCode": 429,
"message": "Rate limit exceeded. Maximum 30 requests per minute.",
"error": "Too Many Requests"
}
⌘I
curl -X GET "https://api.hexagraph.in/institutions?filter=type:facility&sort=outputs_count:desc&per_page=25"
fetch("https://api.hexagraph.in/institutions?filter=type:facility&sort=outputs_count:desc&per_page=25")
.then(response => response.json())
.then(data => console.log(data));
import requests
response = requests.get("https://api.hexagraph.in/institutions", params={"filter": "type:facility", "sort": "outputs_count:desc", "per_page": 25})
print(response.json())
{
"meta": {
"count": 134448,
"page": 1,
"per_page": 25
},
"results": [
{
"id": "HX_I4210108322",
"ror": "https://ror.org/01t3wyv61",
"name": "National Institute for Fusion Science",
"country": {
"code": "JP",
"name": "Japan"
},
"type": "facility",
"homepage_url": "https://www.nifs.ac.jp",
"image_url": null,
"image_thumbnail_url": null,
"display_name_acronyms": [
"NIFS"
],
"display_name_alternatives": [
"Kakuyugo Kagaku Kenkyujo",
"Kakuyugou Kagaku Kenkyuujo",
"Kakuyūgō Kagaku Kenkyūjo",
"NINS National Institute for Fusion Science",
"National Institute for Fusion Science",
"National Institutes of Natural Sciences National Institute for Fusion Science",
"かくゆうごうかがくけんきゅうじょ",
"カクユウゴウカガクケンキュウジョ",
"核融合科学研究所"
],
"repositories": [
{
"id": "HX_S4306401138",
"name": "National Institute for Fusion Science Repository (National Institute for Fusion Science)"
}
],
"outputs_count": 40567916,
"cited_by_count": 2350640,
"summary_stats": {
"2yr_mean_citedness": 0.000029117814157264747,
"h_index": 194,
"i10_index": 18840
},
"associated_institutions": [
{
"id": "HX_I199525922",
"name": "National Institutes of Natural Sciences",
"relationship": "parent"
}
],
"counts_by_year": [
{
"year": 2026,
"outputs_count": 11617444,
"oa_outputs_count": 11617410,
"cited_by_count": 49
},
{
"year": 2025,
"outputs_count": 18940305,
"oa_outputs_count": 18940235,
"cited_by_count": 442
},
{
"year": 2024,
"outputs_count": 10000445,
"oa_outputs_count": 10000376,
"cited_by_count": 1130
}
],
"roles": [
{
"role": "funder",
"id": "HX_F4320338091",
"outputs_count": 2266
},
{
"role": "institution",
"id": "HX_I4210108322",
"outputs_count": 40567916
}
],
"geo": {
"city": "Toki",
"geonames_city_id": "1850207",
"region": null,
"country_code": "JP",
"country": "Japan",
"latitude": 35.349998474121094,
"longitude": 137.18333435058594
},
"international": {},
"updated_date": "2026-08-05T05:59:45",
"created_date": "2022-02-02T04:48:36",
"topics": [
{
"id": "HX_T12157",
"name": "Geochemistry and Geologic Mapping"
},
{
"id": "HX_T13067",
"name": "Geological Modeling and Analysis"
},
{
"id": "HX_T10346",
"name": "Magnetic confinement fusion research"
}
]
}
]
}
{
"statusCode": 400,
"message": "Bad Request - Invalid query parameters",
"error": "Bad Request"
}
{
"statusCode": 429,
"message": "Rate limit exceeded. Maximum 30 requests per minute.",
"error": "Too Many Requests"
}