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

> Búsqueda paginada de personas (investigadores) por palabras clave y filtros.

## Parámetros de consulta

**keywords** `string`

Texto de búsqueda (nombre o parte del nombre de la persona).

**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 personas: `citations`, `products`, `h` y `h5`. Ejemplo:
`products_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`.

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

**data** `array`

Lista de personas.

**propiedades de cada persona**

**id** `string`

Identificador de la persona.

**full\_name** `string`

Nombre completo.

**first\_names** `string[]`

Nombres.

**last\_names** `string[]`

Apellidos.

**initials** `string`

Iniciales.

**aliases** `string[]`

Variantes del nombre con las que aparece en las fuentes.

**sex** `string | null`

Sexo.

**products\_count** `integer`

Cantidad de productos.

**h\_index** `integer`

Índice h.

**h5\_index** `integer`

Índice h de los últimos 5 años.

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

Citaciones por fuente: `count`, `source`, `provenance`.

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

Identificadores externos (`id`, `source`, `provenance`), como ORCID,
OpenAlex, Scienti o Google Scholar.

**affiliations** `object[]`

Afiliaciones de la persona (institución, facultad, departamento, grupo).
Las fechas (`start_date`, `end_date`) están en segundos Unix. Un
`end_date` de `-1` indica una afiliación vigente.

**degrees** `object[]`

Formación académica.

**ranking** `object[]`

Categorías y clasificaciones (contrato, jornada, categoría laboral,
Minciencias).

**subjects** `object[]`

Áreas de conocimiento agrupadas por fuente.

**keywords** `string[]`

Palabras clave.

**related\_works** `array`

Trabajos relacionados.

**updated** `object[]`

Fecha de ú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": [
    {
      "affiliations": [
        {
          "end_date": -1,
          "external_urls": [],
          "id": "example-institution-id",
          "name": "Universidad Ejemplo",
          "position": null,
          "start_date": 1514851200,
          "types": [{"code": null, "level": null, "provenance": null, "source": "ror", "type": "education", "type_class": null}],
          "years": [2018]
        }
      ],
      "aliases": ["maría ejemplo garcía"],
      "citations_count": [{"count": 18, "provenance": null, "source": "openalex"}],
      "degrees": [{"date": -1, "degree": "maestría", "id": "", "institutions": [], "source": "nivel_académico"}],
      "external_ids": [{"id": "0000000001", "provenance": "scienti", "source": "scienti"}],
      "first_names": ["María"],
      "full_name": "María Ejemplo García",
      "h5_index": 3,
      "h_index": 3,
      "id": "0000000001",
      "initials": "M",
      "keywords": [],
      "last_names": ["Ejemplo"],
      "products_count": 21,
      "ranking": [
        {
          "date": 1514869200,
          "from_date": null,
          "issn": null,
          "level": null,
          "order": null,
          "rank": "vinculado",
          "source": "tipo_contrato",
          "to_date": null
        }
      ],
      "related_works": [],
      "sex": "Hombre",
      "subjects": [],
      "updated": [{"source": "staff", "time": 1790089863}]
    },
    {
      "affiliations": [
        {
          "end_date": 1797552000,
          "external_urls": [],
          "id": "example-institution-id",
          "name": "Universidad Ejemplo",
          "position": null,
          "start_date": 1768780800,
          "types": [{"code": null, "level": null, "provenance": null, "source": "ror", "type": "education", "type_class": null}],
          "years": [2026]
        }
      ],
      "aliases": ["juan ejemplo pérez"],
      "citations_count": [{"count": 54, "provenance": null, "source": "openalex"}],
      "degrees": [],
      "external_ids": [{"id": "0000000002", "provenance": "scienti", "source": "scienti"}],
      "first_names": ["Juan"],
      "full_name": "Juan Ejemplo Pérez",
      "h5_index": 1,
      "h_index": 3,
      "id": "0000000002",
      "initials": "J",
      "keywords": [],
      "last_names": ["Ejemplo"],
      "products_count": 96,
      "ranking": [
        {
          "date": 1768798800,
          "from_date": null,
          "issn": null,
          "level": null,
          "order": null,
          "rank": "ocasional",
          "source": "tipo_contrato",
          "to_date": null
        }
      ],
      "related_works": [],
      "sex": "Hombre",
      "subjects": [
        {
          "provenance": "minciencias",
          "source": "OECD",
          "subjects": [
            {
              "external_ids": [{"id": "2", "provenance": null, "source": "OECD"}],
              "id": "",
              "level": 0,
              "name": "Ingeniería y Tecnología"
            }
          ]
        }
      ],
      "updated": [{"source": "staff", "time": 1790089863}]
    }
  ],
  "meta": {
    "count": 1542618,
    "cursor": {"next": "https://api.dev.impactu.colav.co/search/person?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.