Search persons
curl --request GET \
--url https://api.dev.impactu.colav.co/search/personimport requests
url = "https://api.dev.impactu.colav.co/search/person"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.dev.impactu.colav.co/search/person', 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/person",
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/person"
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/person")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.dev.impactu.colav.co/search/person")
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": [
{
"affiliations": [
{
"end_date": -1,
"external_urls": [],
"id": "example-institution-id",
"name": "Universidad Ejemplo",
"position": null,
"start_date": 1514851200,
"types": [{"code": null, "level": null, "provenance": null, "source": "ror", "type": "education", "type_class": null}],
"years": [2018]
}
],
"aliases": ["maría ejemplo garcía"],
"citations_count": [{"count": 18, "provenance": null, "source": "openalex"}],
"degrees": [{"date": -1, "degree": "maestría", "id": "", "institutions": [], "source": "nivel_académico"}],
"external_ids": [{"id": "0000000001", "provenance": "scienti", "source": "scienti"}],
"first_names": ["María"],
"full_name": "María Ejemplo García",
"h5_index": 3,
"h_index": 3,
"id": "0000000001",
"initials": "M",
"keywords": [],
"last_names": ["Ejemplo"],
"products_count": 21,
"ranking": [
{
"date": 1514869200,
"from_date": null,
"issn": null,
"level": null,
"order": null,
"rank": "vinculado",
"source": "tipo_contrato",
"to_date": null
}
],
"related_works": [],
"sex": "Hombre",
"subjects": [],
"updated": [{"source": "staff", "time": 1790089863}]
},
{
"affiliations": [
{
"end_date": 1797552000,
"external_urls": [],
"id": "example-institution-id",
"name": "Universidad Ejemplo",
"position": null,
"start_date": 1768780800,
"types": [{"code": null, "level": null, "provenance": null, "source": "ror", "type": "education", "type_class": null}],
"years": [2026]
}
],
"aliases": ["juan ejemplo pérez"],
"citations_count": [{"count": 54, "provenance": null, "source": "openalex"}],
"degrees": [],
"external_ids": [{"id": "0000000002", "provenance": "scienti", "source": "scienti"}],
"first_names": ["Juan"],
"full_name": "Juan Ejemplo Pérez",
"h5_index": 1,
"h_index": 3,
"id": "0000000002",
"initials": "J",
"keywords": [],
"last_names": ["Ejemplo"],
"products_count": 96,
"ranking": [
{
"date": 1768798800,
"from_date": null,
"issn": null,
"level": null,
"order": null,
"rank": "ocasional",
"source": "tipo_contrato",
"to_date": null
}
],
"related_works": [],
"sex": "Hombre",
"subjects": [
{
"provenance": "minciencias",
"source": "OECD",
"subjects": [
{
"external_ids": [{"id": "2", "provenance": null, "source": "OECD"}],
"id": "",
"level": 0,
"name": "Ingeniería y Tecnología"
}
]
}
],
"updated": [{"source": "staff", "time": 1790089863}]
}
],
"meta": {
"count": 1542618,
"cursor": {"next": "https://api.dev.impactu.colav.co/search/person?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 persons
Paginated search of persons (researchers) by keywords and filters.
GET
/
search
/
person
Search persons
curl --request GET \
--url https://api.dev.impactu.colav.co/search/personimport requests
url = "https://api.dev.impactu.colav.co/search/person"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.dev.impactu.colav.co/search/person', 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/person",
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/person"
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/person")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.dev.impactu.colav.co/search/person")
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": [
{
"affiliations": [
{
"end_date": -1,
"external_urls": [],
"id": "example-institution-id",
"name": "Universidad Ejemplo",
"position": null,
"start_date": 1514851200,
"types": [{"code": null, "level": null, "provenance": null, "source": "ror", "type": "education", "type_class": null}],
"years": [2018]
}
],
"aliases": ["maría ejemplo garcía"],
"citations_count": [{"count": 18, "provenance": null, "source": "openalex"}],
"degrees": [{"date": -1, "degree": "maestría", "id": "", "institutions": [], "source": "nivel_académico"}],
"external_ids": [{"id": "0000000001", "provenance": "scienti", "source": "scienti"}],
"first_names": ["María"],
"full_name": "María Ejemplo García",
"h5_index": 3,
"h_index": 3,
"id": "0000000001",
"initials": "M",
"keywords": [],
"last_names": ["Ejemplo"],
"products_count": 21,
"ranking": [
{
"date": 1514869200,
"from_date": null,
"issn": null,
"level": null,
"order": null,
"rank": "vinculado",
"source": "tipo_contrato",
"to_date": null
}
],
"related_works": [],
"sex": "Hombre",
"subjects": [],
"updated": [{"source": "staff", "time": 1790089863}]
},
{
"affiliations": [
{
"end_date": 1797552000,
"external_urls": [],
"id": "example-institution-id",
"name": "Universidad Ejemplo",
"position": null,
"start_date": 1768780800,
"types": [{"code": null, "level": null, "provenance": null, "source": "ror", "type": "education", "type_class": null}],
"years": [2026]
}
],
"aliases": ["juan ejemplo pérez"],
"citations_count": [{"count": 54, "provenance": null, "source": "openalex"}],
"degrees": [],
"external_ids": [{"id": "0000000002", "provenance": "scienti", "source": "scienti"}],
"first_names": ["Juan"],
"full_name": "Juan Ejemplo Pérez",
"h5_index": 1,
"h_index": 3,
"id": "0000000002",
"initials": "J",
"keywords": [],
"last_names": ["Ejemplo"],
"products_count": 96,
"ranking": [
{
"date": 1768798800,
"from_date": null,
"issn": null,
"level": null,
"order": null,
"rank": "ocasional",
"source": "tipo_contrato",
"to_date": null
}
],
"related_works": [],
"sex": "Hombre",
"subjects": [
{
"provenance": "minciencias",
"source": "OECD",
"subjects": [
{
"external_ids": [{"id": "2", "provenance": null, "source": "OECD"}],
"id": "",
"level": 0,
"name": "Ingeniería y Tecnología"
}
]
}
],
"updated": [{"source": "staff", "time": 1790089863}]
}
],
"meta": {
"count": 1542618,
"cursor": {"next": "https://api.dev.impactu.colav.co/search/person?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…"
}
Query parameters
string
Search text (name or part of the person’s 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 persons: citations, products, h and h5. 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.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 applies.Response
array
List of persons.
Show properties of each person
Show properties of each person
string
Person identifier.
string
Full name.
string[]
First names.
string[]
Last names.
string
Initials.
string[]
Name variants with which the author appears in the sources.
string | null
Sex.
integer
Number of products.
integer
H-index.
integer
H-index of the last 5 years.
object[]
Citations by source:
count, source, provenance.object[]
External identifiers (
id, source, provenance), such as ORCID,
OpenAlex, Scienti or Google Scholar.object[]
Affiliations of the person (institution, faculty, department, group).
Dates (
start_date, end_date) are in Unix seconds. An
end_date of -1 means a current affiliation.object[]
Academic degrees.
object[]
Categories and classifications (contract, working hours, job category,
Minciencias).
object[]
Subject areas grouped by source.
string[]
Keywords.
array
Related works.
object[]
Date of the last update by source (
source, time in Unix
seconds).object
{
"data": [
{
"affiliations": [
{
"end_date": -1,
"external_urls": [],
"id": "example-institution-id",
"name": "Universidad Ejemplo",
"position": null,
"start_date": 1514851200,
"types": [{"code": null, "level": null, "provenance": null, "source": "ror", "type": "education", "type_class": null}],
"years": [2018]
}
],
"aliases": ["maría ejemplo garcía"],
"citations_count": [{"count": 18, "provenance": null, "source": "openalex"}],
"degrees": [{"date": -1, "degree": "maestría", "id": "", "institutions": [], "source": "nivel_académico"}],
"external_ids": [{"id": "0000000001", "provenance": "scienti", "source": "scienti"}],
"first_names": ["María"],
"full_name": "María Ejemplo García",
"h5_index": 3,
"h_index": 3,
"id": "0000000001",
"initials": "M",
"keywords": [],
"last_names": ["Ejemplo"],
"products_count": 21,
"ranking": [
{
"date": 1514869200,
"from_date": null,
"issn": null,
"level": null,
"order": null,
"rank": "vinculado",
"source": "tipo_contrato",
"to_date": null
}
],
"related_works": [],
"sex": "Hombre",
"subjects": [],
"updated": [{"source": "staff", "time": 1790089863}]
},
{
"affiliations": [
{
"end_date": 1797552000,
"external_urls": [],
"id": "example-institution-id",
"name": "Universidad Ejemplo",
"position": null,
"start_date": 1768780800,
"types": [{"code": null, "level": null, "provenance": null, "source": "ror", "type": "education", "type_class": null}],
"years": [2026]
}
],
"aliases": ["juan ejemplo pérez"],
"citations_count": [{"count": 54, "provenance": null, "source": "openalex"}],
"degrees": [],
"external_ids": [{"id": "0000000002", "provenance": "scienti", "source": "scienti"}],
"first_names": ["Juan"],
"full_name": "Juan Ejemplo Pérez",
"h5_index": 1,
"h_index": 3,
"id": "0000000002",
"initials": "J",
"keywords": [],
"last_names": ["Ejemplo"],
"products_count": 96,
"ranking": [
{
"date": 1768798800,
"from_date": null,
"issn": null,
"level": null,
"order": null,
"rank": "ocasional",
"source": "tipo_contrato",
"to_date": null
}
],
"related_works": [],
"sex": "Hombre",
"subjects": [
{
"provenance": "minciencias",
"source": "OECD",
"subjects": [
{
"external_ids": [{"id": "2", "provenance": null, "source": "OECD"}],
"id": "",
"level": 0,
"name": "Ingeniería y Tecnología"
}
]
}
],
"updated": [{"source": "staff", "time": 1790089863}]
}
],
"meta": {
"count": 1542618,
"cursor": {"next": "https://api.dev.impactu.colav.co/search/person?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…"
}