Productos de un autor

Lista de forma paginada los productos de investigación de un autor, o devuelve uno de sus indicadores con el parámetro plot.

GET /person/{person_id}/research/products

Productos de un autor

cURL

curl --request GET \
  --url https://api.dev.impactu.colav.co/person/{person_id}/research/products

200

{
  "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
  }
}

Este endpoint tiene dos modos:

• Listado de productos (sin plot): devuelve los productos del autor con paginación, orden y filtros.
• Indicadores (con plot): devuelve los datos de un indicador del autor. Consulta el catálogo de indicadores.

​

Parámetros de ruta

person_id · string · requerido

Identificador del autor. Ejemplo: 0000000001.

​

Parámetros de consulta

max · integer · predeterminado: "10"

Resultados por página (1 a 250).

page · integer · predeterminado: "1"

Número de página (mínimo 1).

sort · string · predeterminado: "citations_desc"

Criterio de ordenamiento ascendente y descendente, por ejemplo citations_desc, products_asc o alphabetical_desc.

sort · string · predeterminado: "citations_desc"

Ordenamiento con el formato campo_direccion, donde la dirección es asc o desc. Campos para productos: citations, alphabetical (por título) y year (año de publicación). Ejemplo: year_desc.

view · string · predeterminado: "full"

Nivel de detalle de la respuesta. full devuelve todos los campos. summary devuelve solo los campos principales de la entidad y, en productos, patentes y proyectos, recorta la lista de autores a 10. Otro valor responde 400.

fields · string

Campos de primer nivel que quieres recibir de cada producto, separados por coma. id se devuelve siempre. No admite campos anidados. Campos permitidos: id, authors, titles, keywords, topics, subjects, source, types, year_published, citations_by_year, citations_count y updated. Un campo fuera de la lista responde 400. No cambia los resultados, su orden ni meta.count. Ejemplo: fields=authors,titles.

plot · string

Nombre del indicador a devolver. Con este parámetro la respuesta es el indicador, sin paginación. Consulta el catálogo de indicadores.

​

Filtros

Los mismos filtros de Buscar productos. También aplican a los indicadores.

years · string

Rango de años: mínimo y máximo separados por coma. Ejemplo: 2020,2026.

product_types · string

Tipos de producto. Ejemplo: impactu_Artículo de revista.

status · string

Estado de acceso abierto. Ejemplo: diamond,gold.

topics · string

Tópicos de OpenAlex (URL). Ejemplo: https://openalex.org/T14483.

countries · string

Países de los coautores, por código. Ejemplo: CO.

authors_count · string

Cantidad de autores: 5 (exacto), 5- (5 o más), -5 (hasta 5) o 5-8 (rango).

authors_ranking · string

Clasificación de los autores. Ejemplo: Investigador Junior.

groups_ranking · string

Clasificación de los grupos. Ejemplo: A1,A.

institutions_type · string

Tipo de institución de los coautores (ROR). Ejemplo: education,company.

Las opciones válidas se consultan en Filtros de productos de un autor.

Si no envías max, page ni sort, se aplican max=10, page=1 y sort=citations_desc. Si envías max y page sin sort, se aplica sort=citations_desc.

​

Respuesta del listado

data · array

Lista de productos.

Mostrar propiedades de cada producto

id · string

Identificador del producto.

title · string

Título principal.

titles · object[]

Títulos por fuente (title, lang, source).

abstracts · object[]

Resúmenes por fuente.

year_published · integer

Año de publicación.

date_published · integer

Fecha de publicación en segundos Unix, cuando se conoce.

language · string

Idioma.

doi · string

DOI.

keywords · string[]

Palabras clave.

authors · object[]

Primeros 100 autores, en orden de firma (10 con view=summary), con sus afiliaciones y clasificaciones (id, full_name, first_names, last_names, affiliations, ranking, external_ids). El total está en authors_count. Ver Autores de los productos.

authors_count · integer

Cantidad de autores.

groups · object[]

Grupos de investigación asociados, con sus citas y clasificaciones.

citations_count · object[]

Citas por fuente.

citations_by_year · object[]

Citas por año.

bibliographic_info · object

Volumen, número y páginas.

source · object

Fuente (revista) donde se publicó.

open_access · object

Estado de acceso abierto.

apc · object

Información de APC.

product_types · object[]

Tipos de producto (name, source).

types · object[]

Tipos por fuente, con su nivel.

ranking · object[]

Clasificaciones del producto (por ejemplo, de Minciencias).

primary_topic · object

Tópico principal.

topics · object[]

Tópicos.

subjects · object[]

Áreas de conocimiento.

external_ids · object[]

Identificadores externos.

external_urls · object[]

Enlaces externos.

references · array

Referencias.

updated · object[]

Última actualización por fuente.

meta · object

Metadatos de la respuesta.

Mostrar propiedades

count · integer

Total de resultados que cumplen la consulta.

page · integer

Página actual.

size · integer

Cantidad de resultados devueltos en esta página.

db_response_time_ms · integer

Tiempo de respuesta de la base de datos en milisegundos.

cursor · object

Mostrar propiedades

next · string | null

URL de la página siguiente.

previous · string | null

URL de la página anterior.

200

{
  "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
  }
}