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

# Buscar productos

> Búsqueda paginada de productos de investigación (works) por palabras clave y filtros.

## Parámetros de consulta

**keywords** `string`

Texto de búsqueda (título y contenido del producto).

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

### Filtros

Todos los filtros aceptan varios valores separados por coma. Las opciones válidas de cada uno se consultan en [Filtros disponibles de productos](https://help.impactu.colav.co/api-reference/search/works-filters.md).

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

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

A diferencia de los listados de productos de una entidad, esta búsqueda incluye los campos sin dato con valor `null`.

**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`, `provenance`).

**subtitle** `string | null`

Subtítulo.

**abstracts** `object[]`

Resúmenes por fuente. El texto viene como índice invertido (palabra →
posiciones).

**year\_published** `integer`

Año de publicación.

**date\_published** `integer`

Fecha de publicación en segundos Unix.

**language** `string`

Idioma.

**doi** `string | null`

DOI.

**authors** `object[]`

Primeros 100 autores del producto, en orden de firma (10 con
`view=summary`). 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.

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

Citas por fuente (`count`, `source`, `provenance`).

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

Citas por año (`year`, `cited_by_count`).

**bibliographic\_info** `object`

Volumen, número, página inicial y final.

**abstract** `string | null`

Resumen principal.

**bibtex** `string | null`

Entrada BibTeX.

**volume** `string | integer | null`

Volumen. Copia de `bibliographic_info.volume`.

**pages** `string | null`

Páginas. Copia de `bibliographic_info.pages`.

**start\_page** `string | null`

Página inicial. Copia de `bibliographic_info.start_page`.

**end\_page** `string | null`

Página final. Copia de `bibliographic_info.end_page`.

**publisher** `string | null`

Nombre de la editorial.

**references\_count** `integer | null`

Cantidad de referencias.

**ranking** `object[]`

Clasificaciones del producto (por ejemplo, de Minciencias).

**affiliations\_data** `null`

Campo interno; siempre llega en `null`.

**source** `object`

Fuente (revista) donde se publicó: nombre, ISSN, editorial, APC, rankings
y tipos.

**open\_access** `object`

Estado de acceso abierto (`is_open_access`, `open_access_status`, `url`,
`has_repository_fulltext`).

**apc** `object`

Información de APC del producto.

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

Tipos de producto (`name`, `source`).

**types** `object[]`

Tipos del producto por fuente.

**primary\_topic** `object`

Tópico principal, con dominio, campo y subcampo.

**topics** `object[]`

Tópicos del producto con su `score`.

**subjects** `object[]`

Áreas de conocimiento agrupadas por fuente.

**keywords** `string[]`

Palabras clave.

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

Identificadores externos (OpenAlex, DOI, MAG, DSpace, etc.).

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

Enlaces externos (acceso abierto, repositorio).

**groups** `array`

Grupos de investigación asociados.

**references** `array`

Referencias.

**updated** `object[]`

Última actualización por fuente (`source`, `time` en segundos Unix).

**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": [
    {
      "abstract": null,
      "abstracts": [
        {
          "abstract": {
            "1078": [176],
            "2015": [180],
            "27001.": [215],
            "Colombia,": [166],
            "Comunicaciones": [97],
            "Constitución": [163],
            "Decreto": [174],
            "Educación": [252],
            "Educativas": [233],
            "El": [0],
            "En": [75],
            "Estrategia": [191],
            "Gestión": [110],
            "Gobierno": [193],
            "IEC": [214],
            "IED’s": [235],
            "IED’s.": [261],
            "Implementación": [228],
            "Información": [94],
            "Instituciones": [232],
            "Internacional": [212],
            "La": [139],
            "Línea": [195],
            "MINTIC": [99],
            "Ministerio": [89],
            "NTC/ISO": [213],
            "Nacional,": [253],
            "Norma": [211],
            "Reglamentario": [175],
            "SGSI": [117],
            "Seguridad": [112],
            "Sistemas": [108],
            "Tecnologías": [91],
            "a": [9],
            "acercamiento": [120],
            "aras": [76],
            "armonía": [243],
            "asegurando": [69],
            "avance": [1],
            "basado": [208],
            "brindando": [126],
            "buscando": [118],
            "básica": [141],
            "básica,": [241],
            "cada": [39],
            "calidad,": [46],
            "circunscrito": [171],
            "ciudadanía,": [125],
            "colombianas,": [201],
            "como": [13],
            "competitividad": [32],
            "con": [123],
            "confianza": [131],
            "confidencialidad.": [74],
            "consagrado": [160],
            "continuidad": [30],
            "convertido": [22],
            "criterios": [63],
            "criterios,": [81],
            "cual": [168],
            "cumplimiento": [60],
            "de": [3],
            "del": [51],
            "derecho": [154],
            "directrices": [103],
            "educación": [140],
            "educativos": [239],
            "el": [59],
            "en": [23],
            "encuentra": [170],
            "entidades": [199],
            "es": [142],
            "establece": [183],
            "establecido": [101],
            "establecidos": [247],
            "establecimiento": [204],
            "estado": [122],
            "estado,": [148],
            "estos": [80],
            "exigente": [42],
            "facilite": [226],
            "fin": [221],
            "fundamental": [26],
            "garantizar": [28],
            "generales": [104],
            "ha": [100],
            "han": [21],
            "hardware": [12],
            "implementación": [188],
            "implementar": [107],
            "incluyendo": [202],
            "información": [7],
            "instituciones": [84],
            "integridad,": [71],
            "la": [18],
            "las": [34],
            "lineamientos": [185],
            "los": [4],
            "mayo": [178],
            "mercado": [38],
            "modelo": [224],
            "más": [41],
            "necesidades": [257],
            "nivel": [10],
            "niñas": [159],
            "niños": [157],
            "ofrece": [146],
            "oportunidad": [47],
            "organizaciones": [35],
            "para": [27],
            "permiten": [106],
            "pilar": [25],
            "política": [164],
            "por": [248],
            "presente": [217],
            "prestación": [136],
            "presten": [237],
            "procurando": [58],
            "propias": [258],
            "proponer": [222],
            "públicas": [200],
            "público": [87],
            "que": [105],
            "relacionada,": [57],
            "requerimientos": [246],
            "se": [20],
            "sector": [86],
            "seguridad": [49],
            "servicio": [52],
            "servicios": [238],
            "servicios.": [138],
            "sistemas": [5],
            "software": [15],
            "su": [70],
            "tanto": [8],
            "tecnológico": [2],
            "tendientes": [16],
            "tesis": [218],
            "tiene": [219],
            "todas": [197],
            "transacciones,": [130],
            "términos": [44],
            "ubicuidad": [19],
            "un": [24],
            "vez": [40],
            "y": [31],
            "–": [98]
          },
          "lang": "es",
          "provenance": "dspace",
          "source": "dspace"
        }
      ],
      "affiliations_data": null,
      "apc": {
        "charges": null,
        "currency": null,
        "paid": {"currency": null, "provenance": null, "source": null, "value": null, "value_usd": null}
      },
      "authors": [
        {
          "affiliations": [
            {
              "addresses": [
                {
                  "city": "Pereira",
                  "country": "Colombia",
                  "country_code": "CO",
                  "lat": null,
                  "lng": null,
                  "postcode": null,
                  "state": null
                }
              ],
              "end_date": "",
              "external_ids": [{"id": "example-minciencias-id", "provenance": null, "source": "minciencias"}],
              "h5_index": null,
              "h_index": null,
              "id": "COL0000001",
              "name": "Grupo de Investigación Ejemplo",
              "position": null,
              "ranking": null,
              "ror": null,
              "start_date": 1494997200,
              "types": [
                {
                  "code": null,
                  "level": null,
                  "provenance": null,
                  "source": "minciencias",
                  "type": "group",
                  "type_class": null
                }
              ],
              "years": []
            }
          ],
          "countries": null,
          "external_ids": [{"id": "0000000001", "provenance": "minciencias", "source": "scienti"}],
          "first_names": ["María"],
          "full_name": "María Ejemplo García",
          "h5_index": null,
          "h_index": null,
          "id": "0000000001",
          "last_names": ["Ejemplo"],
          "ranking": [
            {
              "date": 1575608400,
              "from_date": null,
              "issn": null,
              "level": null,
              "order": "12",
              "rank": "Investigador Junior",
              "source": "minciencias",
              "to_date": null
            }
          ],
          "sex": "Hombre",
          "type": "author"
        }
      ],
      "authors_count": 3,
      "bibliographic_info": {"bibtex": null, "end_page": null, "issue": null, "pages": null, "start_page": null, "volume": null},
      "bibtex": null,
      "citations_by_year": [],
      "citations_count": [],
      "date_published": null,
      "doi": "",
      "end_page": null,
      "external_ids": [{"id": "AAD-0000000001-45-1", "provenance": "minciencias", "source": "minciencias"}],
      "external_urls": [{"provenance": "dspace", "source": "dspace", "url": "https://repositorio.autonoma.edu.co/handle/11182/691"}],
      "groups": [
        {
          "citations_count": [],
          "h5_index": null,
          "h_index": null,
          "id": "COL0000001",
          "name": "Grupo de Investigación Ejemplo",
          "ranking": [
            {
              "date": 1575608400,
              "from_date": null,
              "issn": null,
              "level": null,
              "order": "2",
              "rank": "C",
              "source": "minciencias",
              "to_date": null
            }
          ]
        }
      ],
      "id": "6ab4ac3c5418a51e324cb2c2",
      "keywords": [],
      "language": "es",
      "open_access": {"has_repository_fulltext": null, "is_open_access": null, "open_access_status": null, "url": null},
      "pages": null,
      "primary_topic": {
        "display_name": "Occupational Health and Safety in Workplaces",
        "domain": {"display_name": "Health Sciences", "id": "https://openalex.org/domains/4"},
        "field": {"display_name": "Health Professions", "id": "https://openalex.org/fields/36"},
        "id": "https://openalex.org/T13315",
        "score": 0.9387,
        "subfield": {"display_name": "Occupational Therapy", "id": "https://openalex.org/subfields/3609"}
      },
      "product_types": [{"name": "Obras o productos de arte, arquitectura y diseño", "source": "minciencias"}],
      "publisher": null,
      "ranking": [
        {
          "date": 1575608400,
          "from_date": null,
          "issn": null,
          "level": null,
          "order": null,
          "rank": "AAD-AAD_C",
          "source": "minciencias",
          "to_date": null
        }
      ],
      "references": [],
      "references_count": null,
      "source": {
        "apc": null,
        "external_ids": null,
        "external_urls": null,
        "id": null,
        "is_in_doaj": null,
        "issn": [],
        "issn_l": null,
        "name": null,
        "names": null,
        "publisher": null,
        "ranking": null,
        "scimago_quartile": null,
        "serials": null,
        "types": null,
        "updated": null
      },
      "start_page": null,
      "subjects": [],
      "subtitle": null,
      "title": "MODELO DE SISTEMA DE GESTIÓN DE SEGURIDAD DE LA INFORMACIÓN BASADO EN LA NORMA NTC/ISO IEC 27001 PARA INSTITUCIONES DE EDUCACIÓN BÁSICA DE LA COMUNA UNIVERSIDAD…",
      "titles": [
        {
          "lang": "es",
          "provenance": null,
          "source": "minciencias",
          "title": "MODELO DE SISTEMA DE GESTIÓN DE SEGURIDAD DE LA INFORMACIÓN BASADO EN LA NORMA NTC/ISO IEC 27001 PARA INSTITUCIONES DE EDUCACIÓN BÁSICA DE LA COMUNA UNIVERSIDAD…"
        }
      ],
      "topics": [
        {
          "display_name": "Occupational Health and Safety in Workplaces",
          "domain": {"display_name": "Health Sciences", "id": "https://openalex.org/domains/4"},
          "field": {"display_name": "Health Professions", "id": "https://openalex.org/fields/36"},
          "id": "https://openalex.org/T13315",
          "score": 0.9387,
          "subfield": {"display_name": "Occupational Therapy", "id": "https://openalex.org/subfields/3609"}
        }
      ],
      "types": [
        {
          "code": null,
          "level": 1,
          "provenance": "minciencias",
          "source": "minciencias",
          "type": "Obras o productos de arte, arquitectura y diseño",
          "type_class": null
        }
      ],
      "updated": [{"source": "minciencias", "time": 1790225466}],
      "volume": null,
      "year_published": 2017
    },
    {
      "abstract": null,
      "abstracts": [],
      "affiliations_data": null,
      "apc": {
        "charges": null,
        "currency": null,
        "paid": {"currency": null, "provenance": null, "source": null, "value": null, "value_usd": null}
      },
      "authors": [
        {
          "affiliations": [
            {
              "addresses": [
                {
                  "city": "Cartagena de Indias",
                  "country": "Colombia",
                  "country_code": "CO",
                  "lat": null,
                  "lng": null,
                  "postcode": null,
                  "state": null
                }
              ],
              "end_date": "",
              "external_ids": [{"id": "example-minciencias-id", "provenance": null, "source": "minciencias"}],
              "h5_index": null,
              "h_index": null,
              "id": "COL0000002",
              "name": "Grupo de Investigación Ejemplo",
              "position": null,
              "ranking": null,
              "ror": null,
              "start_date": 1511931600,
              "types": [
                {
                  "code": null,
                  "level": null,
                  "provenance": null,
                  "source": "minciencias",
                  "type": "group",
                  "type_class": null
                }
              ],
              "years": []
            }
          ],
          "countries": null,
          "external_ids": [{"id": "0000000004", "provenance": "scienti", "source": "scienti"}],
          "first_names": ["Carlos"],
          "full_name": "Carlos Ejemplo Rodríguez",
          "h5_index": null,
          "h_index": null,
          "id": "0000000004",
          "last_names": ["Ejemplo"],
          "ranking": [
            {
              "date": 1575608400,
              "from_date": null,
              "issn": null,
              "level": null,
              "order": "12",
              "rank": "Investigador Junior",
              "source": "minciencias",
              "to_date": null
            }
          ],
          "sex": "Mujer",
          "type": null
        }
      ],
      "authors_count": 1,
      "bibliographic_info": {"bibtex": null, "end_page": null, "issue": null, "pages": null, "start_page": null, "volume": null},
      "bibtex": null,
      "citations_by_year": [],
      "citations_count": [],
      "date_published": null,
      "doi": "",
      "end_page": null,
      "external_ids": [{"id": "AAD-0000000004-116-1", "provenance": "minciencias", "source": "minciencias"}],
      "external_urls": [],
      "groups": [
        {
          "citations_count": [{"count": 18, "provenance": null, "source": "openalex"}],
          "h5_index": null,
          "h_index": null,
          "id": "COL0000002",
          "name": "Grupo de Investigación Ejemplo",
          "ranking": [
            {
              "date": 1614229200,
              "from_date": null,
              "issn": null,
              "level": null,
              "order": "3",
              "rank": "B",
              "source": "minciencias",
              "to_date": null
            }
          ]
        }
      ],
      "id": "6ab4ac3c5418a51e324cb2c3",
      "keywords": [],
      "language": "es",
      "open_access": {"has_repository_fulltext": null, "is_open_access": null, "open_access_status": null, "url": null},
      "pages": null,
      "primary_topic": {"display_name": null, "domain": null, "field": null, "id": null, "score": null, "subfield": null},
      "product_types": [{"name": "Obras o productos de arte, arquitectura y diseño", "source": "minciencias"}],
      "publisher": null,
      "ranking": [
        {
          "date": 1614229200,
          "from_date": null,
          "issn": null,
          "level": null,
          "order": null,
          "rank": "AAD-AAD_C",
          "source": "minciencias",
          "to_date": null
        }
      ],
      "references": [],
      "references_count": null,
      "source": {
        "apc": null,
        "external_ids": null,
        "external_urls": null,
        "id": null,
        "is_in_doaj": null,
        "issn": [],
        "issn_l": null,
        "name": null,
        "names": null,
        "publisher": null,
        "ranking": null,
        "scimago_quartile": null,
        "serials": null,
        "types": null,
        "updated": null
      },
      "start_page": null,
      "subjects": [],
      "subtitle": null,
      "title": "ESTRATEGIAS PARA LA TOMA DE DECISIONES EN EL SECTOR SALUD: CASO ?SIME E.U?",
      "titles": [
        {
          "lang": "es",
          "provenance": null,
          "source": "minciencias",
          "title": "ESTRATEGIAS PARA LA TOMA DE DECISIONES EN EL SECTOR SALUD: CASO ?SIME E.U?"
        }
      ],
      "topics": [],
      "types": [
        {
          "code": null,
          "level": 1,
          "provenance": "minciencias",
          "source": "minciencias",
          "type": "Obras o productos de arte, arquitectura y diseño",
          "type_class": null
        }
      ],
      "updated": [{"source": "minciencias", "time": 1790225468}],
      "volume": null,
      "year_published": null
    }
  ],
  "meta": {
    "count": 2891978,
    "cursor": {"next": "https://api.dev.impactu.colav.co/search/works?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\nmax\n  Input should be greater than or equal to 1 [type=greater_than_equal, input_value='0', input_type=str]\n    For further i…"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.