Buscar entidades geográficas
curl --request GET \
--url https://api.dev.impactu.colav.co/search/geo/{geo_type}import requests
url = "https://api.dev.impactu.colav.co/search/geo/{geo_type}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.dev.impactu.colav.co/search/geo/{geo_type}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.dev.impactu.colav.co/search/geo/{geo_type}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.dev.impactu.colav.co/search/geo/{geo_type}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.dev.impactu.colav.co/search/geo/{geo_type}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.dev.impactu.colav.co/search/geo/{geo_type}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"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
}
}
{
"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
}
}
{"error": "Invalid geo_type. Allowed values: city, state"}
Search
Buscar entidades geográficas
Búsqueda paginada de ciudades y departamentos de Colombia.
GET
/
search
/
geo
/
{geo_type}
Buscar entidades geográficas
curl --request GET \
--url https://api.dev.impactu.colav.co/search/geo/{geo_type}import requests
url = "https://api.dev.impactu.colav.co/search/geo/{geo_type}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.dev.impactu.colav.co/search/geo/{geo_type}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.dev.impactu.colav.co/search/geo/{geo_type}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.dev.impactu.colav.co/search/geo/{geo_type}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.dev.impactu.colav.co/search/geo/{geo_type}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.dev.impactu.colav.co/search/geo/{geo_type}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"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
}
}
{
"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
}
}
{"error": "Invalid geo_type. Allowed values: city, state"}
Parámetros de ruta
string
required
Tipo de entidad geográfica:
city (ciudades) o state (departamentos).
Cualquier otro valor responde con error 400.Parámetros de consulta
string
Texto de búsqueda (nombre de la ciudad o del departamento).
integer
default:"10"
Resultados por página (1 a 250).
integer
default:"1"
Número de página (mínimo 1).
string
default:"citations_desc"
Criterio de ordenamiento ascendente y descendente, por ejemplo
citations_desc, products_asc o alphabetical_desc.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.Este endpoint no tiene filtros.
Respuesta
La estructura cambia segúngeo_type. Los campos comunes son:
array
Lista de entidades geográficas.
Show propiedades de cada entidad
Show propiedades de cada entidad
string
Identificador (código DANE).
string
Nombre.
string
city o state.string
País.
string
Código del país (por ejemplo,
CO).object[]
Identificadores externos (
id, source), como el código DANE.integer
Cantidad de autores.
integer
Cantidad de grupos de investigación.
integer
Cantidad de instituciones.
integer
Cantidad de productos.
object[]
Citas por fuente (
count, source).object
Solo con
city: departamento al que pertenece (id, name).number
Solo con
city: latitud.number
Solo con
city: longitud.integer
Solo con
state: cantidad de ciudades.object
Metadatos de la respuesta.
Show propiedades
Show propiedades
{
"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
}
}
{
"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
}
}
{"error": "Invalid geo_type. Allowed values: city, state"}