Search affiliations
curl --request GET \
--url https://api.dev.impactu.colav.co/search/affiliations/{affiliation_type}import requests
url = "https://api.dev.impactu.colav.co/search/affiliations/{affiliation_type}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.dev.impactu.colav.co/search/affiliations/{affiliation_type}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.dev.impactu.colav.co/search/affiliations/{affiliation_type}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.dev.impactu.colav.co/search/affiliations/{affiliation_type}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.dev.impactu.colav.co/search/affiliations/{affiliation_type}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.dev.impactu.colav.co/search/affiliations/{affiliation_type}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"data": [
{
"abbreviations": ["UE"],
"addresses": [
{
"city": "Gothenburg",
"country": "Suecia",
"country_code": "SE",
"lat": 57.70716,
"lng": 11.96679,
"postcode": "",
"state": "Västra Götaland"
}
],
"affiliations": null,
"aliases": [],
"citations_count": [{"count": 69, "provenance": null, "source": "scholar"}],
"description": [],
"external_ids": [{"id": "example-grid-id", "provenance": "ror", "source": "grid"}],
"external_urls": [{"provenance": null, "source": "grid", "url": "https://www.example.edu.co"}],
"h5_index": 0,
"h_index": 1,
"id": "example-institution-id",
"name": "Universidad Ejemplo",
"names": [{"lang": "en", "name": "Universidad Ejemplo", "provenance": null, "source": "ror"}],
"products_count": 1,
"ranking": [],
"relations": [],
"status": ["active"],
"subjects": [],
"types": [{"code": null, "level": null, "provenance": null, "source": "ror", "type": "archive", "type_class": null}],
"updated": [{"source": "ror", "time": 1789879262}],
"year_established": 2001
},
{
"abbreviations": ["UE"],
"addresses": [
{
"city": "Londres",
"country": "Reino Unido",
"country_code": "GB",
"lat": 51.50853,
"lng": -0.12574,
"postcode": "",
"state": "England"
}
],
"affiliations": null,
"aliases": [],
"citations_count": [{"count": 83, "provenance": null, "source": "openalex"}],
"description": [],
"external_ids": [{"id": "example-wikidata-id", "provenance": "ror", "source": "wikidata"}],
"external_urls": [{"provenance": "wikidata", "source": "logo", "url": "https://www.example.edu.co"}],
"h5_index": 1,
"h_index": 3,
"id": "example-institution-id-2",
"name": "Universidad Ejemplo 2",
"names": [{"lang": "en", "name": "Universidad Ejemplo 2", "provenance": null, "source": "ror"}],
"products_count": 11,
"ranking": [],
"relations": [],
"status": ["active"],
"subjects": [],
"types": [{"code": null, "level": null, "provenance": null, "source": "ror", "type": "archive", "type_class": null}],
"updated": [{"source": "ror", "time": 1789879262}],
"year_established": 1753
}
],
"meta": {
"count": 55111,
"cursor": {"next": "https://api.dev.impactu.colav.co/search/affiliations/institution?max=2&page=2", "previous": null},
"db_response_time_ms": 25,
"page": 1,
"size": 2
}
}
{
"error": "1 validation error for QueryParams\nmax\n Input should be greater than or equal to 1 [type=greater_than_equal, input_value='0', input_type=str]\n For further i…"
}
Search
Search affiliations
Paginated search of affiliations (institutions, faculties, departments and groups).
GET
/
search
/
affiliations
/
{affiliation_type}
Search affiliations
curl --request GET \
--url https://api.dev.impactu.colav.co/search/affiliations/{affiliation_type}import requests
url = "https://api.dev.impactu.colav.co/search/affiliations/{affiliation_type}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.dev.impactu.colav.co/search/affiliations/{affiliation_type}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.dev.impactu.colav.co/search/affiliations/{affiliation_type}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.dev.impactu.colav.co/search/affiliations/{affiliation_type}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.dev.impactu.colav.co/search/affiliations/{affiliation_type}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.dev.impactu.colav.co/search/affiliations/{affiliation_type}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"data": [
{
"abbreviations": ["UE"],
"addresses": [
{
"city": "Gothenburg",
"country": "Suecia",
"country_code": "SE",
"lat": 57.70716,
"lng": 11.96679,
"postcode": "",
"state": "Västra Götaland"
}
],
"affiliations": null,
"aliases": [],
"citations_count": [{"count": 69, "provenance": null, "source": "scholar"}],
"description": [],
"external_ids": [{"id": "example-grid-id", "provenance": "ror", "source": "grid"}],
"external_urls": [{"provenance": null, "source": "grid", "url": "https://www.example.edu.co"}],
"h5_index": 0,
"h_index": 1,
"id": "example-institution-id",
"name": "Universidad Ejemplo",
"names": [{"lang": "en", "name": "Universidad Ejemplo", "provenance": null, "source": "ror"}],
"products_count": 1,
"ranking": [],
"relations": [],
"status": ["active"],
"subjects": [],
"types": [{"code": null, "level": null, "provenance": null, "source": "ror", "type": "archive", "type_class": null}],
"updated": [{"source": "ror", "time": 1789879262}],
"year_established": 2001
},
{
"abbreviations": ["UE"],
"addresses": [
{
"city": "Londres",
"country": "Reino Unido",
"country_code": "GB",
"lat": 51.50853,
"lng": -0.12574,
"postcode": "",
"state": "England"
}
],
"affiliations": null,
"aliases": [],
"citations_count": [{"count": 83, "provenance": null, "source": "openalex"}],
"description": [],
"external_ids": [{"id": "example-wikidata-id", "provenance": "ror", "source": "wikidata"}],
"external_urls": [{"provenance": "wikidata", "source": "logo", "url": "https://www.example.edu.co"}],
"h5_index": 1,
"h_index": 3,
"id": "example-institution-id-2",
"name": "Universidad Ejemplo 2",
"names": [{"lang": "en", "name": "Universidad Ejemplo 2", "provenance": null, "source": "ror"}],
"products_count": 11,
"ranking": [],
"relations": [],
"status": ["active"],
"subjects": [],
"types": [{"code": null, "level": null, "provenance": null, "source": "ror", "type": "archive", "type_class": null}],
"updated": [{"source": "ror", "time": 1789879262}],
"year_established": 1753
}
],
"meta": {
"count": 55111,
"cursor": {"next": "https://api.dev.impactu.colav.co/search/affiliations/institution?max=2&page=2", "previous": null},
"db_response_time_ms": 25,
"page": 1,
"size": 2
}
}
{
"error": "1 validation error for QueryParams\nmax\n Input should be greater than or equal to 1 [type=greater_than_equal, input_value='0', input_type=str]\n For further i…"
}
Path parameters
string
required
Type of affiliation to search:
institution, faculty, department or group.Query parameters
string
Search text (affiliation name).
integer
default:"10"
Results per page (1 to 250).
integer
default:"1"
Page number (minimum 1).
string
default:"citations_desc"
Ascending or descending sort criterion, for example
citations_desc,
products_asc or alphabetical_desc.string
default:"citations_desc"
Sort with the format
field_direction, where the direction is asc or
desc. Fields for affiliations: products (most output), citations
(most citations), h (h-index) and h5 (h5-index). Example: products_desc.string
default:"full"
Level of detail of the response.
full returns every field. summary
returns only the entity’s main fields and, for products, patents and
projects, cuts the author list to 10. Any other value returns 400.Filters
The three filters accept several values separated by commas.string
Departments of the affiliation’s address. The normalized values are used
and their variants in the database are included. Example:
Antioquia,Tolima.string
Cities of the affiliation’s address. Variants such as “Bogotá, D.C.” or
“Santiago de Cali” are also included. Example:
Bogotá,Cali.string
Current classification of the group. It is compared with the most recent ranking (by
from_date), whatever its source. Example: A1,A2.If you don’t send
max, page or sort, max=10, page=1 and
sort=citations_desc apply. If you send max and page without sort,
sort=citations_desc. With affiliation_type=institution all institution
types are included.Response
array
List of affiliations.
Show properties of each affiliation
Show properties of each affiliation
string
Affiliation identifier.
string | null
Main name (in Spanish if there is one).
object[]
Names by source (
name, lang, source, provenance).string[]
Acronyms.
string[]
Alternative names.
object[]
Affiliation types by source (
type, source, provenance).object[]
Addresses:
city, state, country, country_code, postcode,
lat, lng.integer | null
Year founded.
object[]
Descriptions by source.
integer
Number of products.
object[]
Citations by source (
count, source, provenance).integer | null
H-index.
integer | null
H-index of the last 5 years.
object[]
Classifications (for example, a research group’s).
object[] | null
Direct parent affiliations (for example, the institution of a
faculty). In the search it can come as
null.object[]
Related affiliations (
id, name, types, external_urls). For
example, the institution and the departments of a faculty.object[]
Subject areas.
array
Status of the affiliation.
object[]
External identifiers (
id, source, provenance).object[]
External links.
object[]
Last update by source (
source, time in Unix seconds).object
{
"data": [
{
"abbreviations": ["UE"],
"addresses": [
{
"city": "Gothenburg",
"country": "Suecia",
"country_code": "SE",
"lat": 57.70716,
"lng": 11.96679,
"postcode": "",
"state": "Västra Götaland"
}
],
"affiliations": null,
"aliases": [],
"citations_count": [{"count": 69, "provenance": null, "source": "scholar"}],
"description": [],
"external_ids": [{"id": "example-grid-id", "provenance": "ror", "source": "grid"}],
"external_urls": [{"provenance": null, "source": "grid", "url": "https://www.example.edu.co"}],
"h5_index": 0,
"h_index": 1,
"id": "example-institution-id",
"name": "Universidad Ejemplo",
"names": [{"lang": "en", "name": "Universidad Ejemplo", "provenance": null, "source": "ror"}],
"products_count": 1,
"ranking": [],
"relations": [],
"status": ["active"],
"subjects": [],
"types": [{"code": null, "level": null, "provenance": null, "source": "ror", "type": "archive", "type_class": null}],
"updated": [{"source": "ror", "time": 1789879262}],
"year_established": 2001
},
{
"abbreviations": ["UE"],
"addresses": [
{
"city": "Londres",
"country": "Reino Unido",
"country_code": "GB",
"lat": 51.50853,
"lng": -0.12574,
"postcode": "",
"state": "England"
}
],
"affiliations": null,
"aliases": [],
"citations_count": [{"count": 83, "provenance": null, "source": "openalex"}],
"description": [],
"external_ids": [{"id": "example-wikidata-id", "provenance": "ror", "source": "wikidata"}],
"external_urls": [{"provenance": "wikidata", "source": "logo", "url": "https://www.example.edu.co"}],
"h5_index": 1,
"h_index": 3,
"id": "example-institution-id-2",
"name": "Universidad Ejemplo 2",
"names": [{"lang": "en", "name": "Universidad Ejemplo 2", "provenance": null, "source": "ror"}],
"products_count": 11,
"ranking": [],
"relations": [],
"status": ["active"],
"subjects": [],
"types": [{"code": null, "level": null, "provenance": null, "source": "ror", "type": "archive", "type_class": null}],
"updated": [{"source": "ror", "time": 1789879262}],
"year_established": 1753
}
],
"meta": {
"count": 55111,
"cursor": {"next": "https://api.dev.impactu.colav.co/search/affiliations/institution?max=2&page=2", "previous": null},
"db_response_time_ms": 25,
"page": 1,
"size": 2
}
}
{
"error": "1 validation error for QueryParams\nmax\n Input should be greater than or equal to 1 [type=greater_than_equal, input_value='0', input_type=str]\n For further i…"
}