> ## 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 entidades geográficas

> Búsqueda paginada de ciudades y departamentos de Colombia.

## Parámetros de ruta

**geo\_type** `string` *required*

Tipo de entidad geográfica: `city` (ciudades) o `state` (departamentos).
Cualquier otro valor responde con error 400.

## Parámetros de consulta

**keywords** `string`

Texto de búsqueda (nombre de la ciudad o del departamento).

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

Ordenamiento con el formato `campo_direccion`, donde la dirección es `asc` o
`desc`. Para entidades geográficas, `alphabetical` ordena por nombre. Ejemplo:
`alphabetical_asc`.

> [!NOTE]
>
> Este endpoint no tiene filtros.

## Respuesta

La estructura cambia según `geo_type`. Los campos comunes son:

**data** `array`

Lista de entidades geográficas.

**propiedades de cada entidad**

**id** `string`

Identificador (código DANE).

**name** `string`

Nombre.

**type** `string`

`city` o `state`.

**country** `string`

País.

**country\_code** `string`

Código del país (por ejemplo, `CO`).

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

Identificadores externos (`id`, `source`), como el código DANE.

**authors\_count** `integer`

Cantidad de autores.

**groups\_count** `integer`

Cantidad de grupos de investigación.

**institutions\_count** `integer`

Cantidad de instituciones.

**products\_count** `integer`

Cantidad de productos.

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

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

**state** `object`

Solo con `city`: departamento al que pertenece (`id`, `name`).

**latitude** `number`

Solo con `city`: latitud.

**longitude** `number`

Solo con `city`: longitud.

**cities\_count** `integer`

Solo con `state`: cantidad de ciudades.

**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 — Ciudad theme={null}
{
  "data": [
    {
      "authors_count": 0,
      "citations_count": [{"count": 0, "source": "openalex"}],
      "country": "Colombia",
      "country_code": "CO",
      "external_ids": [{"id": "20011", "source": "dane"}],
      "groups_count": 5,
      "id": "20011",
      "institutions_count": 1,
      "latitude": 8.306811,
      "longitude": -73.614027,
      "name": "Aguachica",
      "products_count": 265,
      "state": {"id": "20", "name": "Cesar"},
      "type": "city"
    },
    {
      "authors_count": 0,
      "citations_count": [],
      "country": "Colombia",
      "country_code": "CO",
      "external_ids": [{"id": "15022", "source": "dane"}],
      "groups_count": 1,
      "id": "15022",
      "institutions_count": 2,
      "latitude": 4.970857,
      "longitude": -73.378933,
      "name": "Almeida",
      "products_count": 0,
      "state": {"id": "15", "name": "Boyacá"},
      "type": "city"
    }
  ],
  "meta": {
    "count": 135,
    "cursor": {"next": "https://api.dev.impactu.colav.co/search/geo/city?max=2&page=2", "previous": null},
    "db_response_time_ms": 25,
    "page": 1,
    "size": 2
  }
}
```

```json 200 — Departamento theme={null}
{
  "data": [
    {
      "authors_count": 221,
      "citations_count": [{"count": 9907, "source": "openalex"}],
      "cities_count": 1,
      "country": "Colombia",
      "country_code": "CO",
      "external_ids": [{"id": "91", "source": "dane"}],
      "groups_count": 552,
      "id": "91",
      "institutions_count": 3,
      "name": "Amazonas",
      "products_count": 571,
      "type": "state"
    },
    {
      "authors_count": 43836,
      "citations_count": [{"count": 1172650, "source": "openalex"}],
      "cities_count": 22,
      "country": "Colombia",
      "country_code": "CO",
      "external_ids": [{"id": "05", "source": "dane"}],
      "groups_count": 1117,
      "id": "05",
      "institutions_count": 178,
      "name": "Antioquia",
      "products_count": 295187,
      "type": "state"
    }
  ],
  "meta": {
    "count": 31,
    "cursor": {"next": "https://api.dev.impactu.colav.co/search/geo/state?max=2&page=2", "previous": null},
    "db_response_time_ms": 25,
    "page": 1,
    "size": 2
  }
}
```

```json 400 theme={null}
{"error": "Invalid geo_type. Allowed values: city, state"}
```


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