ENIGH 2024 NS

Encuesta Nacional de Ingresos y Gastos de los Hogares (Nueva Serie).

→ Para uso narrado, ver Tutorial ENIGH.

Namespace

datos_mexico.endpoints.enigh.EnighNamespace

EnighNamespace(http: HttpClient)

Bases: BaseNamespace

Endpoints del dataset ENIGH 2024 Nueva Serie (INEGI).

La ENIGH es una encuesta de corte transversal del INEGI sobre ingresos, gastos y demografía de los hogares mexicanos. La versión Nueva Serie incorpora ajustes metodológicos en la captura de ingresos respecto a la ENIGH Tradicional. Universo: 91,414 hogares en muestra, 38.8M expandidos.

Estos endpoints exponen agregados nacionales y por decil/entidad, las actividades económicas de los hogares, y un panel de validaciones contra cifras oficiales INEGI.

Examples:

>>> from datos_mexico import DatosMexico
>>> with DatosMexico() as client:
...     summary = client.enigh.hogares_summary()
...     print(f"{summary.n_hogares_expandido:,} hogares")
38,830,230 hogares

hogares_summary

hogares_summary() -> HogaresSummary

KPIs nacionales de hogares (muestra, expandido, ingresos, gastos).

Endpoint: GET /api/v1/enigh/hogares/summary

hogares_by_decil

hogares_by_decil() -> list[DecilRow]

Distribución de hogares por decil de ingreso (10 deciles).

Endpoint: GET /api/v1/enigh/hogares/by-decil

hogares_by_entidad

hogares_by_entidad(
    entidad: str | None = None,
) -> list[EntidadRow]

Distribución por entidad federativa.

Sin filtro retorna las 32 entidades; con filtro retorna sólo la entidad solicitada (lista de 1 elemento).

Endpoint: GET /api/v1/enigh/hogares/by-entidad

Parameters:

Name	Type	Description	Default
entidad	str | None	Clave de entidad federativa (ej. "09" para CDMX). Si es None se devuelven todas.	None

Raises:

Type	Description
NotFoundError	Si entidad no existe en el catálogo.

gastos_by_rubro

gastos_by_rubro(
    *, decil: int | None = None
) -> RubrosResponse

Composición del gasto monetario por rubro (9 rubros).

Cada rubro incluye su gasto medio, su porcentaje del gasto monetario total, y la cifra oficial INEGI con su delta porcentual cuando hay comparativo directo disponible (oficial_mensual, bound_delta_pct).

Endpoint: GET /api/v1/enigh/gastos/by-rubro

Parameters:

Name	Type	Description	Default
decil	int | None	Filtrar a un decil específico (1-10). None (default) devuelve la cifra nacional.	None

Raises:

Type	Description
ValueError	Si decil está fuera del rango [1, 10].

poblacion_demographics

poblacion_demographics(
    entidad: str | None = None,
) -> DemographicsResponse

Pirámide demográfica (sexo y edad) nacional o por entidad.

Endpoint: GET /api/v1/enigh/poblacion/demographics

Parameters:

Name	Type	Description	Default
entidad	str | None	Clave de entidad federativa. None retorna nacional.	None

actividad_agro

actividad_agro() -> ActividadAgroResponse

Hogares con actividad agropecuaria (cultivo, ganadería, pesca).

Endpoint: GET /api/v1/enigh/actividad/agro

actividad_noagro

actividad_noagro() -> ActividadNoagroResponse

Hogares con actividad económica no agropecuaria.

Endpoint: GET /api/v1/enigh/actividad/noagro

actividad_jcf

actividad_jcf() -> ActividadJcfResponse

Hogares con actividad por jornal o cuenta familiar.

Endpoint: GET /api/v1/enigh/actividad/jcf

metadata

metadata() -> EnighMetadata

Metadata sobre la edición ENIGH (NS 2024) y notas metodológicas.

Endpoint: GET /api/v1/enigh/metadata

validaciones

validaciones() -> ValidacionesResponse

Validaciones del observatorio contra cifras oficiales INEGI.

Cada bound compara una cifra calculada por el observatorio con la cifra oficial INEGI directamente. passing es True cuando la diferencia absoluta cae dentro de la tolerancia configurada.

Endpoint: GET /api/v1/enigh/validaciones

Modelos

Modelos Pydantic para el dataset ENIGH 2024 Nueva Serie.

Cobertura: hogares (summary, deciles, entidades), gastos por rubro, demografía, actividades agropecuaria/no-agropecuaria/JCF, metadata y validaciones contra cifras INEGI oficiales.

Convenciones (consistentes con CONSAR):

• Campos monetarios (mean_*_trim, mean_*_mensual, oficial_*, calculado) usan Decimal con BeforeValidator(_to_decimal) para preservar precisión y permitir aritmética exacta. La precisión importa especialmente para bound_delta_pct y oficial_mensual, que documentan la diferencia entre el cálculo del observatorio y la cifra oficial INEGI.
• Porcentajes (pct_*, share_*) también como Decimal.
• Sumas y conteos (n_*, sum_*) como int.
• extra="allow" heredado del base config: si la API agrega campos, no rompe.

HogaresSummary

Bases: DatosMexicoModel

Respuesta de GET /api/v1/enigh/hogares/summary.

KPIs nacionales del padrón de hogares en la ENIGH 2024 NS: tamaño de muestra, factores de expansión, ingreso y gasto medios trimestrales y mensuales.

DecilRow

Bases: DatosMexicoModel

Fila por decil de ingreso.

Devuelta como elemento del array GET /api/v1/enigh/hogares/by-decil.

EntidadRow

Bases: DatosMexicoModel

Fila por entidad federativa.

Devuelta como elemento del array GET /api/v1/enigh/hogares/by-entidad.

RubroRow

Bases: DatosMexicoModel

Fila por rubro de gasto monetario.

Los campos oficial_mensual y bound_delta_pct documentan la validación contra la cifra oficial publicada por INEGI: el observatorio expone ambas para que el usuario pueda auditar el cálculo. Llegan como None cuando INEGI no publica una cifra oficial directamente comparable para ese rubro o decil.

RubrosResponse

Bases: DatosMexicoModel

Respuesta de GET /api/v1/enigh/gastos/by-rubro.

Cuando decil es None la cifra es nacional; cuando es un entero 1..10 la cifra corresponde a ese decil de ingreso.

SexoCount

Bases: DatosMexicoModel

Conteo expandido de personas por sexo.

EdadBucket

Bases: DatosMexicoModel

Bucket de edad con conteo expandido.

DemographicsResponse

Bases: DatosMexicoModel

Respuesta de GET /api/v1/enigh/poblacion/demographics.

scope indica si la cifra es nacional o de una entidad específica.

ActividadDecilRow

Bases: DatosMexicoModel

Distribución de hogares con una actividad por decil de ingreso.

ActividadEntidadRow

Bases: DatosMexicoModel

Top entidades por hogares con la actividad.

ActividadAgroResponse

Bases: DatosMexicoModel

Respuesta de GET /api/v1/enigh/actividad/agro.

Hogares con actividad agropecuaria (cultivo, ganadería, pesca).

ActividadNoagroResponse

Bases: DatosMexicoModel

Respuesta de GET /api/v1/enigh/actividad/noagro.

Hogares con actividad económica no agropecuaria (negocios, comercio, servicios).

JcfEntidadRow

Bases: DatosMexicoModel

Beneficiarios de jornal/cuenta familiar por entidad.

ActividadJcfResponse

Bases: DatosMexicoModel

Respuesta de GET /api/v1/enigh/actividad/jcf.

Hogares con actividad por jornal o cuenta familiar (autoempleo o trabajo familiar no remunerado formalmente).

SourceRef

Bases: DatosMexicoModel

Referencia a una fuente primaria consultada.

EnighMetadata

Bases: DatosMexicoModel

Respuesta de GET /api/v1/enigh/metadata.

Información sobre la edición de la ENIGH, fuentes primarias y notas metodológicas.

ValidacionRow

Bases: DatosMexicoModel

Una validación individual contra una cifra oficial INEGI.

passing es True cuando |delta_pct| <= tolerance_pct.

ValidacionesResponse

Bases: DatosMexicoModel

Respuesta de GET /api/v1/enigh/validaciones.

Resumen de las validaciones del observatorio contra cifras oficiales INEGI: count total de validaciones, passing y failing con el detalle en bounds.