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
requerido
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
predeterminado:"10"
Resultados por página (1 a 250).
integer
predeterminado:"1"
Número de página (mínimo 1).
string
predeterminado:"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.
Mostrar propiedades de cada entidad
Mostrar 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.
Mostrar propiedades
Mostrar propiedades
integer
Total de resultados que cumplen la consulta.
integer
Página actual.
integer
Cantidad de resultados devueltos en esta página.
integer
Tiempo de respuesta de la base de datos en milisegundos.
{
"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"}