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

# Search projects

> Paginated search of research projects by keywords.

## Query parameters

**keywords** `string`

Search text (project title).

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

Sort with the format `alphabetical_asc` or `alphabetical_desc` (by title).
Example: `alphabetical_asc`.

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

> [!NOTE]
>
> This endpoint has no filters.

## Response

**data** `array`

List of projects.

**properties of each project**

**id** `string`

Project identifier.

**title** `string`

Title.

**titles** `object[]`

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

**abstract** `string`

Abstract.

**language** `string`

Language.

**keywords** `string[] | null`

Keywords.

**authors** `object[]`

Authors (researchers), with their affiliations.

**authors\_count** `integer`

Number of authors.

**groups** `object[]`

Associated research groups (`id`, `name`).

**date\_init** `integer | null`

Start date in Unix seconds.

**date\_end** `integer | null`

End date in Unix seconds.

**year\_init** `integer | null`

Start year.

**year\_end** `integer | null`

End year.

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

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

**types** `object[]`

Project types by source, with their level (`type`, `code`, `level`,
`source`).

**ranking** `object[]`

Classifications.

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

External identifiers (`id`, `source`, `provenance`).

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

External links.

**updated** `object[]`

Last update by source (`source`, `time` in Unix seconds).

**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": [
    {
      "abstract": "",
      "authors": [
        {
          "affiliations": [
            {
              "addresses": null,
              "end_date": null,
              "external_ids": null,
              "h5_index": null,
              "h_index": null,
              "id": "COL0000001",
              "name": "Grupo de Investigación Ejemplo",
              "position": null,
              "ranking": null,
              "ror": null,
              "start_date": null,
              "types": [
                {
                  "code": null,
                  "level": null,
                  "provenance": null,
                  "source": "minciencias",
                  "type": "group",
                  "type_class": null
                }
              ],
              "years": []
            }
          ],
          "countries": null,
          "external_ids": null,
          "first_names": null,
          "full_name": "María Ejemplo García",
          "h5_index": null,
          "h_index": null,
          "id": "0000000001",
          "last_names": null,
          "ranking": null,
          "sex": null,
          "type": null
        }
      ],
      "authors_count": 1,
      "date_end": null,
      "date_init": null,
      "external_ids": [{"id": "0000000001", "provenance": "minciencias", "source": "scienti"}],
      "external_urls": [],
      "groups": [
        {
          "citations_count": null,
          "h5_index": null,
          "h_index": null,
          "id": "COL0000001",
          "name": "Grupo de Investigación Ejemplo",
          "ranking": null
        }
      ],
      "id": "6ab844cf5418a51e3283862f",
      "keywords": null,
      "language": "es",
      "product_types": [{"name": "Proyecto de extensión", "source": "minciencias"}],
      "ranking": [
        {
          "date": 1575608400,
          "from_date": null,
          "issn": null,
          "level": null,
          "order": null,
          "rank": "PE-PE",
          "source": "minciencias",
          "to_date": null
        }
      ],
      "title": "4.\tFortalecimiento de la gestión del conocimiento en medidas de atención para violencia contra la mujer, estudio de caso municipio del Socorro, Santander 2017-2…",
      "titles": [
        {
          "lang": "es",
          "provenance": null,
          "source": "minciencias",
          "title": "4.\tFortalecimiento de la gestión del conocimiento en medidas de atención para violencia contra la mujer, estudio de caso municipio del Socorro, Santander 2017-2…"
        }
      ],
      "types": [
        {
          "code": null,
          "level": 1,
          "provenance": "minciencias",
          "source": "minciencias",
          "type": "Proyecto de extensión",
          "type_class": null
        }
      ],
      "updated": [{"source": "minciencias", "time": 1790461135}],
      "year_end": null,
      "year_init": null
    },
    {
      "abstract": "",
      "authors": [
        {
          "affiliations": [
            {
              "addresses": null,
              "end_date": null,
              "external_ids": null,
              "h5_index": null,
              "h_index": null,
              "id": "COL0000002",
              "name": "Grupo de Investigación Ejemplo",
              "position": null,
              "ranking": null,
              "ror": null,
              "start_date": null,
              "types": [
                {
                  "code": null,
                  "level": null,
                  "provenance": null,
                  "source": "minciencias",
                  "type": "group",
                  "type_class": null
                }
              ],
              "years": []
            }
          ],
          "countries": null,
          "external_ids": null,
          "first_names": null,
          "full_name": "Juan Ejemplo Pérez",
          "h5_index": null,
          "h_index": null,
          "id": "0000000002",
          "last_names": null,
          "ranking": null,
          "sex": null,
          "type": null
        }
      ],
      "authors_count": 1,
      "date_end": null,
      "date_init": null,
      "external_ids": [{"id": "0000000002", "provenance": "minciencias", "source": "scienti"}],
      "external_urls": [],
      "groups": [
        {
          "citations_count": null,
          "h5_index": null,
          "h_index": null,
          "id": "COL0000002",
          "name": "Grupo de Investigación Ejemplo",
          "ranking": null
        }
      ],
      "id": "6ab844cf5418a51e32838630",
      "keywords": null,
      "language": "es",
      "product_types": [{"name": "Proyecto de extensión", "source": "minciencias"}],
      "ranking": [
        {
          "date": 1614229200,
          "from_date": null,
          "issn": null,
          "level": null,
          "order": null,
          "rank": "PE-PE",
          "source": "minciencias",
          "to_date": null
        }
      ],
      "title": "Una mirada a la diversidad y la inclusión social, a través de los estereotipos, culturas y géneros en el diseño de modas",
      "titles": [
        {
          "lang": "es",
          "provenance": null,
          "source": "minciencias",
          "title": "Una mirada a la diversidad y la inclusión social, a través de los estereotipos, culturas y géneros en el diseño de modas"
        }
      ],
      "types": [
        {
          "code": null,
          "level": 1,
          "provenance": "minciencias",
          "source": "minciencias",
          "type": "Proyecto de extensión",
          "type_class": null
        }
      ],
      "updated": [{"source": "minciencias", "time": 1790461135}],
      "year_end": null,
      "year_init": null
    }
  ],
  "meta": {
    "count": 128687,
    "cursor": {"next": "https://api.dev.impactu.colav.co/search/projects?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.