> ## Documentation Index
> Fetch the complete documentation index at: https://help.impactu.colav.co/llms.txt
> Use this file to discover all available pages before exploring further.

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

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](https://help.impactu.colav.co/api-reference/affiliation/plots/overview.md).

## 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](https://help.impactu.colav.co/api-reference/affiliation/plots/overview.md).

### Filtros

Los mismos filtros de [Buscar productos](https://help.impactu.colav.co/api-reference/search/works.md). 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](https://help.impactu.colav.co/api-reference/affiliation/get-research-products-filters.md).

> [!NOTE]
>
> 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.

**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](https://help.impactu.colav.co/guides/authorship.md).

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

**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`

**propiedades**

**next** `string | null`

URL de la página siguiente.

**previous** `string | null`

URL de la página anterior.

```json 200 theme={null}
{
  "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
  }
}
```

```json 400 theme={null}
{
  "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 documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.