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

# Author products

> Paginated list of an author's research products, or one of their indicators with the plot parameter.

This endpoint has two modes:

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

## Path parameters

**person\_id** `string` *required*

Author identifier. Example: `0000000001`.

## Query parameters

**max** `integer` (default: 10)

Results per page (1 to 250).

**page** `integer` (default: 1)

Page number (minimum 1).

**sort** `string` (default: citations\_desc)

Ascending or descending sort criterion, for example `citations_desc`,
`products_asc` or `alphabetical_desc`.

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

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

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

**plot** `string`

Name of the indicator to return. With this parameter the response is the
indicator, without pagination. See the [indicator
catalogue](https://help.impactu.colav.co/en/api-reference/person/plots/overview.md).

### Filters

The same filters as [Search products](https://help.impactu.colav.co/en/api-reference/search/works.md). They also apply to indicators.

**years** `string`

Year range: minimum and maximum separated by a comma. Example: `2020,2026`.

**product\_types** `string`

Product types. Example: `impactu_Artículo de revista`.

**status** `string`

Open access status. Example: `diamond,gold`.

**topics** `string`

OpenAlex topics (URL). Example: `https://openalex.org/T14483`.

**countries** `string`

Co-authors' countries, by code. Example: `CO`.

**authors\_count** `string`

Number of authors: `5` (exactly), `5-` (5 or more), `-5` (up to 5) or `5-8`
(range).

**authors\_ranking** `string`

Author classification. Example: `Investigador Junior`.

**groups\_ranking** `string`

Group classification. Example: `A1,A`.

**institutions\_type** `string`

Co-authors' institution type (ROR). Example: `education,company`.

The valid options can be looked up in [Author product filters](https://help.impactu.colav.co/en/api-reference/person/get-research-products-filters.md).

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

**data** `array`

List of products.

**properties of each product**

**id** `string`

Product identifier.

**title** `string`

Main title.

**titles** `object[]`

Titles by source (`title`, `lang`, `source`).

**abstracts** `object[]`

Abstracts by source.

**year\_published** `integer`

Publication year.

**date\_published** `integer`

Publication date in Unix seconds, when known.

**language** `string`

Language.

**doi** `string`

DOI.

**keywords** `string[]`

Keywords.

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

**authors\_count** `integer`

Number of authors.

**groups** `object[]`

Associated research groups, with their citations and classifications.

**citations\_count** `object[]`

Citations by source.

**citations\_by\_year** `object[]`

Citations per year.

**bibliographic\_info** `object`

Volume, issue and pages.

**source** `object`

Source (journal) where it was published.

**open\_access** `object`

Open access status.

**apc** `object`

APC information.

**product\_types** `object[]`

Product types (`name`, `source`).

**types** `object[]`

Types by source, with their level.

**ranking** `object[]`

Product classifications (for example, from Minciencias).

**primary\_topic** `object`

Primary topic.

**topics** `object[]`

Topics.

**subjects** `object[]`

Subject areas.

**external\_ids** `object[]`

External identifiers.

**external\_urls** `object[]`

External links.

**references** `array`

References.

**updated** `object[]`

Last update by source.

**meta** `object`

Response metadata.

**properties**

**count** `integer`

Total number of results matching the query.

**page** `integer`

Current page.

**size** `integer`

Number of results returned on this page.

**db\_response\_time\_ms** `integer`

Database response time in milliseconds.

**cursor** `object`

**properties**

**next** `string | null`

URL of the next page.

**previous** `string | null`

URL of the previous page.

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

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