Productos de una afiliación

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

GET /affiliation/{affiliation_type}/{affiliation_id}/research/products

Productos de una afiliación

cURL

curl --request GET \
  --url https://api.dev.impactu.colav.co/affiliation/{affiliation_type}/{affiliation_id}/research/products

200

{
  "data": [
    {
      "abstracts": [],
      "apc": {"paid": {}},
      "authors": [
        {
          "affiliations": [
            {
              "addresses": [{"city": "Medellín", "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": 1590987600,
              "types": [{"source": "scienti", "type": "group"}],
              "years": []
            }
          ],
          "external_ids": [{"id": "0000000001", "provenance": "scienti", "source": "scienti"}],
          "first_names": ["María"],
          "full_name": "María Ejemplo García",
          "id": "0000000001",
          "last_names": ["Ejemplo"],
          "ranking": [{"date": 1462408390, "rank": "EM", "source": "scienti"}],
          "sex": "Hombre"
        }
      ],
      "authors_count": 1,
      "bibliographic_info": {},
      "citations_by_year": [],
      "citations_count": [],
      "doi": "",
      "external_ids": [{"id": "AAD-0000000001-6-2", "provenance": "minciencias", "source": "minciencias"}],
      "external_urls": [],
      "groups": [
        {
          "citations_count": [{"count": 8, "source": "scholar"}],
          "id": "COL0000001",
          "name": "Grupo de Investigación Ejemplo",
          "ranking": [{"from_date": 1653368400, "rank": "C", "source": "scienti", "to_date": 1716440400}]
        }
      ],
      "id": "6ab4ac3f5418a51e324cb4cc",
      "keywords": [],
      "language": "es",
      "open_access": {},
      "primary_topic": {},
      "product_types": [{"name": "Obras o productos de arte, arquitectura y diseño", "source": "minciencias"}],
      "ranking": [{"date": 1614229200, "rank": "AAD-AAD_C", "source": "minciencias"}],
      "references": [],
      "source": {},
      "subjects": [],
      "title": "Suite de los ensamblajes",
      "titles": [{"lang": "es", "source": "minciencias", "title": "Suite de los ensamblajes"}],
      "topics": [],
      "types": [
        {
          "level": 1,
          "provenance": "minciencias",
          "source": "minciencias",
          "type": "Obras o productos de arte, arquitectura y diseño"
        }
      ],
      "updated": [{"source": "minciencias", "time": 1790225471}]
    },
    {
      "abstracts": [],
      "apc": {"paid": {}},
      "authors": [
        {
          "affiliations": [
            {
              "addresses": [{"city": "Medellín", "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": 1590987600,
              "types": [{"source": "scienti", "type": "group"}],
              "years": []
            }
          ],
          "external_ids": [{"id": "0000000001", "provenance": "scienti", "source": "scienti"}],
          "first_names": ["María"],
          "full_name": "María Ejemplo García",
          "id": "0000000001",
          "last_names": ["Ejemplo"],
          "ranking": [{"date": 1462408390, "rank": "EM", "source": "scienti"}],
          "sex": "Hombre"
        }
      ],
      "authors_count": 1,
      "bibliographic_info": {},
      "citations_by_year": [],
      "citations_count": [],
      "doi": "",
      "external_ids": [{"id": "AAD-0000000001-8-4", "provenance": "minciencias", "source": "minciencias"}],
      "external_urls": [],
      "groups": [
        {
          "citations_count": [{"count": 8, "source": "scholar"}],
          "id": "COL0000001",
          "name": "Grupo de Investigación Ejemplo",
          "ranking": [{"from_date": 1653368400, "rank": "C", "source": "scienti", "to_date": 1716440400}]
        }
      ],
      "id": "6ab4ac3f5418a51e324cb4cd",
      "keywords": [],
      "language": "es",
      "open_access": {},
      "primary_topic": {},
      "product_types": [{"name": "Obras o productos de arte, arquitectura y diseño", "source": "minciencias"}],
      "ranking": [{"date": 1614229200, "rank": "AAD-AAD_C", "source": "minciencias"}],
      "references": [],
      "source": {},
      "subjects": [],
      "title": "Un Si mayor por la paz",
      "titles": [{"lang": "es", "source": "minciencias", "title": "Un Si mayor por la paz"}],
      "topics": [],
      "types": [
        {
          "level": 1,
          "provenance": "minciencias",
          "source": "minciencias",
          "type": "Obras o productos de arte, arquitectura y diseño"
        }
      ],
      "updated": [{"source": "minciencias", "time": 1790225471}]
    }
  ],
  "meta": {
    "count": 135364,
    "cursor": {
      "next": "https://api.dev.impactu.colav.co/affiliation/institution/example-institution-id/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 de la afiliación, con paginación, orden y filtros.
• Indicadores (con plot): devuelve los datos de un indicador de la afiliación. Consulta el catálogo de indicadores.

Parámetros de ruta

affiliation_type · string · required

Tipo de afiliación: institution, faculty, department o group.

affiliation_id · string · required

Identificador de la afiliación. Ejemplos: 03bp5hc83 (institución), 03bp5hc83_20 (facultad).

Parámetros de consulta

max · integer · default: "10"

Resultados por página (1 a 250).

page · integer · default: "1"

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

sort · string · default: "citations_desc"

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

sort · string · default: "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 · default: "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. Todos aceptan varios valores separados por coma.

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 una afiliación.

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.

Show 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.

Show 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

Show 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": "Medellín", "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": 1590987600,
              "types": [{"source": "scienti", "type": "group"}],
              "years": []
            }
          ],
          "external_ids": [{"id": "0000000001", "provenance": "scienti", "source": "scienti"}],
          "first_names": ["María"],
          "full_name": "María Ejemplo García",
          "id": "0000000001",
          "last_names": ["Ejemplo"],
          "ranking": [{"date": 1462408390, "rank": "EM", "source": "scienti"}],
          "sex": "Hombre"
        }
      ],
      "authors_count": 1,
      "bibliographic_info": {},
      "citations_by_year": [],
      "citations_count": [],
      "doi": "",
      "external_ids": [{"id": "AAD-0000000001-6-2", "provenance": "minciencias", "source": "minciencias"}],
      "external_urls": [],
      "groups": [
        {
          "citations_count": [{"count": 8, "source": "scholar"}],
          "id": "COL0000001",
          "name": "Grupo de Investigación Ejemplo",
          "ranking": [{"from_date": 1653368400, "rank": "C", "source": "scienti", "to_date": 1716440400}]
        }
      ],
      "id": "6ab4ac3f5418a51e324cb4cc",
      "keywords": [],
      "language": "es",
      "open_access": {},
      "primary_topic": {},
      "product_types": [{"name": "Obras o productos de arte, arquitectura y diseño", "source": "minciencias"}],
      "ranking": [{"date": 1614229200, "rank": "AAD-AAD_C", "source": "minciencias"}],
      "references": [],
      "source": {},
      "subjects": [],
      "title": "Suite de los ensamblajes",
      "titles": [{"lang": "es", "source": "minciencias", "title": "Suite de los ensamblajes"}],
      "topics": [],
      "types": [
        {
          "level": 1,
          "provenance": "minciencias",
          "source": "minciencias",
          "type": "Obras o productos de arte, arquitectura y diseño"
        }
      ],
      "updated": [{"source": "minciencias", "time": 1790225471}]
    },
    {
      "abstracts": [],
      "apc": {"paid": {}},
      "authors": [
        {
          "affiliations": [
            {
              "addresses": [{"city": "Medellín", "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": 1590987600,
              "types": [{"source": "scienti", "type": "group"}],
              "years": []
            }
          ],
          "external_ids": [{"id": "0000000001", "provenance": "scienti", "source": "scienti"}],
          "first_names": ["María"],
          "full_name": "María Ejemplo García",
          "id": "0000000001",
          "last_names": ["Ejemplo"],
          "ranking": [{"date": 1462408390, "rank": "EM", "source": "scienti"}],
          "sex": "Hombre"
        }
      ],
      "authors_count": 1,
      "bibliographic_info": {},
      "citations_by_year": [],
      "citations_count": [],
      "doi": "",
      "external_ids": [{"id": "AAD-0000000001-8-4", "provenance": "minciencias", "source": "minciencias"}],
      "external_urls": [],
      "groups": [
        {
          "citations_count": [{"count": 8, "source": "scholar"}],
          "id": "COL0000001",
          "name": "Grupo de Investigación Ejemplo",
          "ranking": [{"from_date": 1653368400, "rank": "C", "source": "scienti", "to_date": 1716440400}]
        }
      ],
      "id": "6ab4ac3f5418a51e324cb4cd",
      "keywords": [],
      "language": "es",
      "open_access": {},
      "primary_topic": {},
      "product_types": [{"name": "Obras o productos de arte, arquitectura y diseño", "source": "minciencias"}],
      "ranking": [{"date": 1614229200, "rank": "AAD-AAD_C", "source": "minciencias"}],
      "references": [],
      "source": {},
      "subjects": [],
      "title": "Un Si mayor por la paz",
      "titles": [{"lang": "es", "source": "minciencias", "title": "Un Si mayor por la paz"}],
      "topics": [],
      "types": [
        {
          "level": 1,
          "provenance": "minciencias",
          "source": "minciencias",
          "type": "Obras o productos de arte, arquitectura y diseño"
        }
      ],
      "updated": [{"source": "minciencias", "time": 1790225471}]
    }
  ],
  "meta": {
    "count": 135364,
    "cursor": {
      "next": "https://api.dev.impactu.colav.co/affiliation/institution/example-institution-id/research/products?max=2&page=2",
      "previous": null
    },
    "db_response_time_ms": 25,
    "page": 1,
    "size": 2
  }
}