{"id":37080562,"url":"https://github.com/sigdeletras/censosine21","last_synced_at":"2026-01-14T09:46:48.228Z","repository":{"id":191029064,"uuid":"683792829","full_name":"sigdeletras/censosine21","owner":"sigdeletras","description":"Python library to interact with the API of the National Institute of Statistics (INE) of Spain that offers the data Dissemination System of the Population and Housing Censuses 2021 (SDC21)","archived":false,"fork":false,"pushed_at":"2023-08-29T09:55:20.000Z","size":136,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-01-04T21:17:10.268Z","etag":null,"topics":["census","ine","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sigdeletras.png","metadata":{"files":{"readme":"README.es-ES.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-08-27T17:59:39.000Z","updated_at":"2025-04-05T12:39:40.000Z","dependencies_parsed_at":"2023-08-28T08:27:09.446Z","dependency_job_id":null,"html_url":"https://github.com/sigdeletras/censosine21","commit_stats":null,"previous_names":["sigdeletras/censosine2021","sigdeletras/censosine21"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/sigdeletras/censosine21","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sigdeletras%2Fcensosine21","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sigdeletras%2Fcensosine21/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sigdeletras%2Fcensosine21/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sigdeletras%2Fcensosine21/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sigdeletras","download_url":"https://codeload.github.com/sigdeletras/censosine21/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sigdeletras%2Fcensosine21/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28416120,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T08:38:59.149Z","status":"ssl_error","status_checked_at":"2026-01-14T08:38:43.588Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["census","ine","python"],"created_at":"2026-01-14T09:46:47.683Z","updated_at":"2026-01-14T09:46:48.212Z","avatar_url":"https://github.com/sigdeletras.png","language":"Python","funding_links":[],"categories":["Datos Abiertos y Estadísticas"],"sub_categories":["Región de Murcia"],"readme":"# censosine21\n\nLibrería Python para interactuar con la API del Instituto Nacional de Estadística ([INE](https://www.ine.es/)) que ofrece datos del [Sistema de Difusión de los Censos de Población y Viviendas 2021 (SDC21)](https://www.ine.es/dyngs/INEbase/es/operacion.htm?c=Estadistica_C\u0026cid=1254736176992\u0026menu=ultiDatos\u0026idp=1254735572981#:~:text=%C3%9Altima%20Nota%20de%20prensa\u0026text=En%20Espa%C3%B1a%20hab%C3%ADa%2018.539.223,2.514.511%20de%20uso%20espor%C3%A1dico.).\n\nRead this in [English](https://github.com/sigdeletras/censosine21/blob/master/README.md).\n\n## Instalación\n\nEl paquete **censosine21** está disponible como una librería de código abierto en [PyPI](https://pypi.org/project/censosine21/).\n\nPuedes instalar **censosine21** ejecutando el siguiente comando:\n```bash\npip install censosine21\n```\n\nSi ya tienes instaladao **censosine21**, puedes actualizarlo usando:\n```bash\npip install censosine21 --upgrade\n```\n\n## Primer paso\n\nEl primer paso para utilizar *censosine21* es crear un objeto *CensosINE21*.\n```python\nfrom censosine21 import CensosINE21\n\nhogares = CensosINE21()\n```\nEn este primer momento, los atributos del objeto no cuentan con datos. Usando el método *post()* la librería realizará la petición a la API según los parámetros indicados (tabla, unidad de medida, variables e idioma) y descargará los datos de la consulta (metadata y data).\n\n```python\nhogares.post(\"hog\", 'SHOGARES', ['ID_RESIDENCIA_N2', 'ID_TENEN_VIV' ], \"ES\")\n```\n\n## Atributos del objeto\n\n- table: Conjunto de datos disponibles del SDC21\n- metrics: Unidad de médida\n- variables: Variables \n- language: Lenguaje usado para los resultados\n- params: json de parámetros para hacer la petición POST a la API\n- api_url: ULR oficial de la API del INE\n- metadata: Metadatos del JSON de respuesta\n- data: Datos del JSON de respuesta\n \n## Conversión a formato CSV y filtros\n\nUna vez realizada la consulta, la clase cuenta con el método *to_csv()* para guardar los datos del atributo data a formato CSV\n\n```python\nhogares.to_csv('csv/nhorares_regimen_provincias.csv')\n```\n\nEs también posible filtrar el conjunto de datos indicando el par clave-valor a partir de la variable y el texto de filtro usando el método *filter()*.\n\n```python\nhogares_filter_asturias = hogares.filter('ID_RESIDENCIA_N2', 'asturias')\n```\n\nEsta misma opción de filtrado también está disponible en el método **to_csv()**\n\n```python\nhogares.to_csv('csv/nhorares_regimen_asturias.csv','ID_RESIDENCIA_N2', '33 Asturias')\n```\n\n## Mostrar información de las entidades de la API\n\nLa librería posee un cojunto de métodos estáticos para acceder a la información de las tablas, unidades de médida y variables de la API y su descripción en español e inglés.\n\nAl ser métodos estáticos no es necesario instanciar un objeto para usarlo. Simplemente usamos la clase y el método de consulta\n\n```python\nfrom censosine21 import CensosINE21\n\nCensosINE21.show_tables()\nCensosINE21.show_metrics()\nCensosINE21.show_variables()\nCensosINE21.show_languages()\n```\n\nLa información sobre métricas y variables puede ser filtrada por tabla.\n\n```python\nCensosINE21.show_metrics('hog')\nCensosINE21.show_variables('nuc')\n```\n## ¿Más ejemplos?\n\nObtenga el código fuente en el [repositorio de github](https://github.com/sigdeletras/censosine21).\n\nHay más ejemplos en el directorio [/examples](https://github.com/sigdeletras/censosine21/tree/master/examples).\n\n## Enlace oficial\n\nPuedes obtener más información sobre cómo funciona la API del INE en la [página oficial de documentación del INE](https://www.ine.es/dyngs/DataLab/es/manual.html?cid=1259945952385)\n\n## Licencia\n\nLa librería *censosine21* está desarrollada por [Patricio Soriano](https://www.linkedin.com/in/patriciosorianocastro/) [@sigdeletras](https://twitter.com/sigdeletras) bajo licencia\n[MIT License.](LICENSE.md)\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsigdeletras%2Fcensosine21","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsigdeletras%2Fcensosine21","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsigdeletras%2Fcensosine21/lists"}