Author products
curl --request GET \
--url https://api.dev.impactu.colav.co/person/{person_id}/research/productsimport requests
url = "https://api.dev.impactu.colav.co/person/{person_id}/research/products"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.dev.impactu.colav.co/person/{person_id}/research/products', 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/person/{person_id}/research/products",
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/person/{person_id}/research/products"
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/person/{person_id}/research/products")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.dev.impactu.colav.co/person/{person_id}/research/products")
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": [
{
"abstracts": [],
"apc": {"paid": {}},
"authors": [
{
"affiliations": [
{
"addresses": [{"city": "Cali", "country": "Colombia", "country_code": "CO"}],
"end_date": -1,
"external_ids": [{"id": "example-scienti-id", "source": "scienti"}],
"id": "COL0000001",
"name": "Grupo de Investigación Ejemplo",
"start_date": 1222837200,
"types": [{"source": "scienti", "type": "group"}],
"years": []
}
],
"external_ids": [{"id": "0000000002", "provenance": "scienti", "source": "scienti"}],
"first_names": ["Juan"],
"full_name": "Juan Ejemplo Pérez",
"id": "0000000002",
"last_names": ["Ejemplo"],
"ranking": [{"date": 570690000, "rank": "vinculado", "source": "tipo_contrato"}],
"sex": "Hombre"
}
],
"authors_count": 3,
"bibliographic_info": {},
"citations_by_year": [],
"citations_count": [],
"date_published": 1546318800,
"doi": "",
"external_ids": [{"id": "0000000002-29521", "provenance": "minciencias", "source": "scienti"}],
"external_urls": [{"provenance": "scienti", "source": "scienti"}],
"groups": [
{
"citations_count": [{"count": 1339, "source": "scholar"}],
"id": "COL0000001",
"name": "Grupo de Investigación Ejemplo",
"ranking": [{"from_date": 1653368400, "rank": "A", "source": "scienti", "to_date": 1716440400}]
}
],
"id": "6ab4addb5418a51e324df255",
"keywords": [],
"language": "en",
"open_access": {},
"primary_topic": {},
"product_types": [{"name": "Publicado en revista especializada", "source": "scienti"}],
"ranking": [{"date": 1614229200, "rank": "ART-ART_A1", "source": "minciencias"}],
"references": [],
"source": {},
"subjects": [],
"title": "An Image Processing System for Char Reactivity Analysis during Coal Combustion",
"titles": [
{
"lang": "en",
"source": "minciencias",
"title": "An Image Processing System for Char Reactivity Analysis during Coal Combustion"
}
],
"topics": [],
"types": [{"level": 1, "provenance": "minciencias", "source": "minciencias", "type": "Artículos de investigación"}],
"updated": [{"source": "minciencias", "time": 1790225883}],
"year_published": 2019
},
{
"abstracts": [],
"apc": {"paid": {}},
"authors": [
{
"affiliations": [
{
"addresses": [{"city": "Cali", "country": "Colombia", "country_code": "CO"}],
"end_date": -1,
"external_ids": [{"id": "example-scienti-id", "source": "scienti"}],
"id": "COL0000002",
"name": "Grupo de Investigación Ejemplo",
"start_date": 1435726800,
"types": [{"source": "scienti", "type": "group"}],
"years": []
}
],
"external_ids": [{"id": "0000000004", "provenance": "scienti", "source": "scienti"}],
"first_names": ["Carlos"],
"full_name": "Carlos Ejemplo Rodríguez",
"id": "0000000004",
"last_names": ["Ejemplo"],
"ranking": [{"date": 697093200, "rank": "vinculado", "source": "tipo_contrato"}],
"sex": "Mujer"
}
],
"authors_count": 3,
"bibliographic_info": {},
"citations_by_year": [],
"citations_count": [],
"date_published": 1525150800,
"doi": "",
"external_ids": [{"id": "0000000004-105", "provenance": "minciencias", "source": "scienti"}],
"external_urls": [{"provenance": "scienti", "source": "scienti", "url": "http://ceur-ws.org/Vol-2100/paper9.pdf"}],
"groups": [
{
"citations_count": [{"count": 882, "source": "scholar"}],
"id": "COL0000002",
"name": "Grupo de Investigación Ejemplo",
"ranking": [{"from_date": 1653368400, "rank": "A", "source": "scienti", "to_date": 1716440400}]
}
],
"id": "6ab4af965418a51e324ef6db",
"keywords": [],
"language": "en",
"open_access": {},
"primary_topic": {},
"product_types": [{"name": "Publicado en revista especializada", "source": "scienti"}],
"ranking": [{"date": 1614229200, "rank": "ART-GC_ART", "source": "minciencias"}],
"references": [],
"source": {},
"subjects": [],
"title": "Ontology-based Automatic Reclassification of Tissues and Organs in Histological Images",
"titles": [
{
"lang": "en",
"source": "minciencias",
"title": "Ontology-based Automatic Reclassification of Tissues and Organs in Histological Images"
}
],
"topics": [],
"types": [{"level": 1, "provenance": "minciencias", "source": "minciencias", "type": "Artículos"}],
"updated": [{"source": "minciencias", "time": 1790226326}],
"year_published": 2018
}
],
"meta": {
"count": 3224,
"cursor": {"next": "https://api.dev.impactu.colav.co/person/0000000001/research/products?max=2&page=2", "previous": null},
"db_response_time_ms": 25,
"page": 1,
"size": 2
}
}
{
"error": "1 validation error for QueryParams\nfields\n Value error, Invalid fields: abstract. Allowed fields: authors, citations_by_year, citations_count, id, keywords, so…"
}
Person
Author products
Paginated list of an author’s research products, or one of their indicators with the plot parameter.
GET
/
person
/
{person_id}
/
research
/
products
Author products
curl --request GET \
--url https://api.dev.impactu.colav.co/person/{person_id}/research/productsimport requests
url = "https://api.dev.impactu.colav.co/person/{person_id}/research/products"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.dev.impactu.colav.co/person/{person_id}/research/products', 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/person/{person_id}/research/products",
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/person/{person_id}/research/products"
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/person/{person_id}/research/products")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.dev.impactu.colav.co/person/{person_id}/research/products")
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": [
{
"abstracts": [],
"apc": {"paid": {}},
"authors": [
{
"affiliations": [
{
"addresses": [{"city": "Cali", "country": "Colombia", "country_code": "CO"}],
"end_date": -1,
"external_ids": [{"id": "example-scienti-id", "source": "scienti"}],
"id": "COL0000001",
"name": "Grupo de Investigación Ejemplo",
"start_date": 1222837200,
"types": [{"source": "scienti", "type": "group"}],
"years": []
}
],
"external_ids": [{"id": "0000000002", "provenance": "scienti", "source": "scienti"}],
"first_names": ["Juan"],
"full_name": "Juan Ejemplo Pérez",
"id": "0000000002",
"last_names": ["Ejemplo"],
"ranking": [{"date": 570690000, "rank": "vinculado", "source": "tipo_contrato"}],
"sex": "Hombre"
}
],
"authors_count": 3,
"bibliographic_info": {},
"citations_by_year": [],
"citations_count": [],
"date_published": 1546318800,
"doi": "",
"external_ids": [{"id": "0000000002-29521", "provenance": "minciencias", "source": "scienti"}],
"external_urls": [{"provenance": "scienti", "source": "scienti"}],
"groups": [
{
"citations_count": [{"count": 1339, "source": "scholar"}],
"id": "COL0000001",
"name": "Grupo de Investigación Ejemplo",
"ranking": [{"from_date": 1653368400, "rank": "A", "source": "scienti", "to_date": 1716440400}]
}
],
"id": "6ab4addb5418a51e324df255",
"keywords": [],
"language": "en",
"open_access": {},
"primary_topic": {},
"product_types": [{"name": "Publicado en revista especializada", "source": "scienti"}],
"ranking": [{"date": 1614229200, "rank": "ART-ART_A1", "source": "minciencias"}],
"references": [],
"source": {},
"subjects": [],
"title": "An Image Processing System for Char Reactivity Analysis during Coal Combustion",
"titles": [
{
"lang": "en",
"source": "minciencias",
"title": "An Image Processing System for Char Reactivity Analysis during Coal Combustion"
}
],
"topics": [],
"types": [{"level": 1, "provenance": "minciencias", "source": "minciencias", "type": "Artículos de investigación"}],
"updated": [{"source": "minciencias", "time": 1790225883}],
"year_published": 2019
},
{
"abstracts": [],
"apc": {"paid": {}},
"authors": [
{
"affiliations": [
{
"addresses": [{"city": "Cali", "country": "Colombia", "country_code": "CO"}],
"end_date": -1,
"external_ids": [{"id": "example-scienti-id", "source": "scienti"}],
"id": "COL0000002",
"name": "Grupo de Investigación Ejemplo",
"start_date": 1435726800,
"types": [{"source": "scienti", "type": "group"}],
"years": []
}
],
"external_ids": [{"id": "0000000004", "provenance": "scienti", "source": "scienti"}],
"first_names": ["Carlos"],
"full_name": "Carlos Ejemplo Rodríguez",
"id": "0000000004",
"last_names": ["Ejemplo"],
"ranking": [{"date": 697093200, "rank": "vinculado", "source": "tipo_contrato"}],
"sex": "Mujer"
}
],
"authors_count": 3,
"bibliographic_info": {},
"citations_by_year": [],
"citations_count": [],
"date_published": 1525150800,
"doi": "",
"external_ids": [{"id": "0000000004-105", "provenance": "minciencias", "source": "scienti"}],
"external_urls": [{"provenance": "scienti", "source": "scienti", "url": "http://ceur-ws.org/Vol-2100/paper9.pdf"}],
"groups": [
{
"citations_count": [{"count": 882, "source": "scholar"}],
"id": "COL0000002",
"name": "Grupo de Investigación Ejemplo",
"ranking": [{"from_date": 1653368400, "rank": "A", "source": "scienti", "to_date": 1716440400}]
}
],
"id": "6ab4af965418a51e324ef6db",
"keywords": [],
"language": "en",
"open_access": {},
"primary_topic": {},
"product_types": [{"name": "Publicado en revista especializada", "source": "scienti"}],
"ranking": [{"date": 1614229200, "rank": "ART-GC_ART", "source": "minciencias"}],
"references": [],
"source": {},
"subjects": [],
"title": "Ontology-based Automatic Reclassification of Tissues and Organs in Histological Images",
"titles": [
{
"lang": "en",
"source": "minciencias",
"title": "Ontology-based Automatic Reclassification of Tissues and Organs in Histological Images"
}
],
"topics": [],
"types": [{"level": 1, "provenance": "minciencias", "source": "minciencias", "type": "Artículos"}],
"updated": [{"source": "minciencias", "time": 1790226326}],
"year_published": 2018
}
],
"meta": {
"count": 3224,
"cursor": {"next": "https://api.dev.impactu.colav.co/person/0000000001/research/products?max=2&page=2", "previous": null},
"db_response_time_ms": 25,
"page": 1,
"size": 2
}
}
{
"error": "1 validation error for QueryParams\nfields\n Value error, Invalid fields: abstract. Allowed fields: authors, citations_by_year, citations_count, id, keywords, so…"
}
This endpoint has two modes:
The valid options can be looked up in Author product filters.
- Product list (without
plot): returns the author’s products with pagination, sorting and filters. - Indicators (with
plot): returns the data of one of the author’s indicators. See the indicator catalogue.
Path parameters
string
required
Author identifier. Example:
0000000001.Query parameters
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 products: citations, alphabetical (by title) and
year (publication year). Example: year_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.string
Top-level fields to receive for each product, separated by commas.
id is
always returned. Nested fields are not supported. Allowed fields: id,
authors, titles, keywords, topics, subjects, source, types,
year_published, citations_by_year, citations_count and updated. A
field outside this list returns 400. It does not change the results, their
order or meta.count. Example: fields=authors,titles.string
Name of the indicator to return. With this parameter the response is the
indicator, without pagination. See the indicator
catalogue.
Filters
The same filters as Search products. They also apply to indicators.string
Year range: minimum and maximum separated by a comma. Example:
2020,2026.string
Product types. Example:
impactu_Artículo de revista.string
Open access status. Example:
diamond,gold.string
OpenAlex topics (URL). Example:
https://openalex.org/T14483.string
Co-authors’ countries, by code. Example:
CO.string
Number of authors:
5 (exactly), 5- (5 or more), -5 (up to 5) or 5-8
(range).string
Author classification. Example:
Investigador Junior.string
Group classification. Example:
A1,A.string
Co-authors’ institution type (ROR). Example:
education,company.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.List response
array
List of products.
Show properties of each product
Show properties of each product
string
Product identifier.
string
Main title.
object[]
Titles by source (
title, lang, source).object[]
Abstracts by source.
integer
Publication year.
integer
Publication date in Unix seconds, when known.
string
Language.
string
DOI.
string[]
Keywords.
object[]
First 100 authors, in signing order (10 with
view=summary), with their
affiliations and classifications (id, full_name, first_names,
last_names, affiliations, ranking, external_ids). The total is in
authors_count. See Product authors.integer
Number of authors.
object[]
Associated research groups, with their citations and classifications.
object[]
Citations by source.
object[]
Citations per year.
object
Volume, issue and pages.
object
Source (journal) where it was published.
object
Open access status.
object
APC information.
object[]
Product types (
name, source).object[]
Types by source, with their level.
object[]
Product classifications (for example, from Minciencias).
object
Primary topic.
object[]
Topics.
object[]
Subject areas.
object[]
External identifiers.
object[]
External links.
array
References.
object[]
Last update by source.
object
{
"data": [
{
"abstracts": [],
"apc": {"paid": {}},
"authors": [
{
"affiliations": [
{
"addresses": [{"city": "Cali", "country": "Colombia", "country_code": "CO"}],
"end_date": -1,
"external_ids": [{"id": "example-scienti-id", "source": "scienti"}],
"id": "COL0000001",
"name": "Grupo de Investigación Ejemplo",
"start_date": 1222837200,
"types": [{"source": "scienti", "type": "group"}],
"years": []
}
],
"external_ids": [{"id": "0000000002", "provenance": "scienti", "source": "scienti"}],
"first_names": ["Juan"],
"full_name": "Juan Ejemplo Pérez",
"id": "0000000002",
"last_names": ["Ejemplo"],
"ranking": [{"date": 570690000, "rank": "vinculado", "source": "tipo_contrato"}],
"sex": "Hombre"
}
],
"authors_count": 3,
"bibliographic_info": {},
"citations_by_year": [],
"citations_count": [],
"date_published": 1546318800,
"doi": "",
"external_ids": [{"id": "0000000002-29521", "provenance": "minciencias", "source": "scienti"}],
"external_urls": [{"provenance": "scienti", "source": "scienti"}],
"groups": [
{
"citations_count": [{"count": 1339, "source": "scholar"}],
"id": "COL0000001",
"name": "Grupo de Investigación Ejemplo",
"ranking": [{"from_date": 1653368400, "rank": "A", "source": "scienti", "to_date": 1716440400}]
}
],
"id": "6ab4addb5418a51e324df255",
"keywords": [],
"language": "en",
"open_access": {},
"primary_topic": {},
"product_types": [{"name": "Publicado en revista especializada", "source": "scienti"}],
"ranking": [{"date": 1614229200, "rank": "ART-ART_A1", "source": "minciencias"}],
"references": [],
"source": {},
"subjects": [],
"title": "An Image Processing System for Char Reactivity Analysis during Coal Combustion",
"titles": [
{
"lang": "en",
"source": "minciencias",
"title": "An Image Processing System for Char Reactivity Analysis during Coal Combustion"
}
],
"topics": [],
"types": [{"level": 1, "provenance": "minciencias", "source": "minciencias", "type": "Artículos de investigación"}],
"updated": [{"source": "minciencias", "time": 1790225883}],
"year_published": 2019
},
{
"abstracts": [],
"apc": {"paid": {}},
"authors": [
{
"affiliations": [
{
"addresses": [{"city": "Cali", "country": "Colombia", "country_code": "CO"}],
"end_date": -1,
"external_ids": [{"id": "example-scienti-id", "source": "scienti"}],
"id": "COL0000002",
"name": "Grupo de Investigación Ejemplo",
"start_date": 1435726800,
"types": [{"source": "scienti", "type": "group"}],
"years": []
}
],
"external_ids": [{"id": "0000000004", "provenance": "scienti", "source": "scienti"}],
"first_names": ["Carlos"],
"full_name": "Carlos Ejemplo Rodríguez",
"id": "0000000004",
"last_names": ["Ejemplo"],
"ranking": [{"date": 697093200, "rank": "vinculado", "source": "tipo_contrato"}],
"sex": "Mujer"
}
],
"authors_count": 3,
"bibliographic_info": {},
"citations_by_year": [],
"citations_count": [],
"date_published": 1525150800,
"doi": "",
"external_ids": [{"id": "0000000004-105", "provenance": "minciencias", "source": "scienti"}],
"external_urls": [{"provenance": "scienti", "source": "scienti", "url": "http://ceur-ws.org/Vol-2100/paper9.pdf"}],
"groups": [
{
"citations_count": [{"count": 882, "source": "scholar"}],
"id": "COL0000002",
"name": "Grupo de Investigación Ejemplo",
"ranking": [{"from_date": 1653368400, "rank": "A", "source": "scienti", "to_date": 1716440400}]
}
],
"id": "6ab4af965418a51e324ef6db",
"keywords": [],
"language": "en",
"open_access": {},
"primary_topic": {},
"product_types": [{"name": "Publicado en revista especializada", "source": "scienti"}],
"ranking": [{"date": 1614229200, "rank": "ART-GC_ART", "source": "minciencias"}],
"references": [],
"source": {},
"subjects": [],
"title": "Ontology-based Automatic Reclassification of Tissues and Organs in Histological Images",
"titles": [
{
"lang": "en",
"source": "minciencias",
"title": "Ontology-based Automatic Reclassification of Tissues and Organs in Histological Images"
}
],
"topics": [],
"types": [{"level": 1, "provenance": "minciencias", "source": "minciencias", "type": "Artículos"}],
"updated": [{"source": "minciencias", "time": 1790226326}],
"year_published": 2018
}
],
"meta": {
"count": 3224,
"cursor": {"next": "https://api.dev.impactu.colav.co/person/0000000001/research/products?max=2&page=2", "previous": null},
"db_response_time_ms": 25,
"page": 1,
"size": 2
}
}
{
"error": "1 validation error for QueryParams\nfields\n Value error, Invalid fields: abstract. Allowed fields: authors, citations_by_year, citations_count, id, keywords, so…"
}