Una API de datos de ayuda para reparar el hogar que los equipos pueden evaluar antes de decidir sobre una licencia
La información sobre ayuda para reparar el hogar está dispersa entre fuentes federales, estatales, de condados, municipales, de servicios públicos, tribales y de organizaciones. Un equipo de producto que quiere ayudar a un propietario a encontrar posibles fondos para reparaciones puede reunir esas fuentes por su cuenta o integrar una capa de descubrimiento mantenida. La API de The Grant Map busca que la segunda opción sea práctica y evaluable.
Comience con evidencia, no con una llamada de ventas: abra el explorador de muestra sin clave (en inglés), revise el contrato OpenAPI 3.1 y lea el resultado vigente de salud de los datos. El resultado de preparación comercial es la decisión de cierre seguro para el pago autoservicio de la licencia comercial anual y la autorización controlada de una exportación. Un resultado verde no es una garantía de exactitud, un compromiso contractual de disponibilidad, una opinión sobre derechos de fuentes ni la aprobación del caso de uso de un comprador. El acceso para organizaciones sin fines de lucro o académicas y los pilotos asistidos requieren revisión manual en lugar de pago autoservicio.
Para qué está diseñada la API
La API organiza registros publicados de subvenciones, reembolsos, préstamos condonables, financiamiento reembolsable, obras de accesibilidad, climatización, reparaciones para viviendas saludables, mitigación de desastres y ayuda relacionada por ciudad. El contrato de cada registro incluye campos de descripción y etiqueta de importe en inglés y español, URL citadas, campos estructurados de proyecto y audiencia, y un objeto freshness con evidencia de alcance definido.
Está diseñada para descubrimiento, orientación dentro de productos, investigación y flujos de asesores. No es un motor de elegibilidad, una solicitud de subvención, un insumo de suscripción financiera ni una promesa de que haya fondos abiertos. La organización administradora sigue controlando la elegibilidad vigente, los fondos, las condiciones del beneficio, los plazos y la vía de solicitud.
Hay cuatro superficies públicas de evaluación
- Datos de muestra:
GET /api/sampledevuelve la colección dentro del alcance y sin registros en cuarentena para una ciudad de evaluación, sin una clave. - Contrato para desarrolladores: la guía técnica (en inglés), el documento OpenAPI y el esquema JSON muestran la estructura y los errores admitidos.
- Evidencia de salud de los datos:
GET /api/dataset/healthinforma la cobertura vigente, las categorías de salud de enlaces, las exclusiones, el estado de auditoría y las fechas de las últimas ejecuciones. - Control comercial:
GET /api/data/readinessindica si los requisitos del conjunto exacto, la auditoría, los derechos, la operación recurrente y la entrega permiten en ese momento el pago autoservicio de la licencia comercial anual y la autorización controlada de una exportación.
Cómo se ve la evaluación pública
Cómo puede verse una integración
Productos de renovación y financiamiento de viviendas
Después de que un propietario elija una ciudad y un tipo de proyecto, muestre posibles registros de ayuda junto a las opciones de financiamiento. Mantenga visibles la fuente citada y la advertencia de verificación. No reduzca el importe de un préstamo ni tome una decisión crediticia basándose en un beneficio sin confirmar.
Asesores de vivienda y organizaciones comunitarias
Use los campos de audiencia, requisitos de ingresos, proyecto y geografía para preparar una lista de investigación antes de una sesión de asesoría. El resultado puede reducir búsquedas repetidas sin reemplazar la revisión de fuentes del asesor ni la decisión del administrador.
Plataformas de servicios para el hogar y contratistas
Ofrezca al propietario una vía para investigar posibles fondos antes o junto con un presupuesto. La API de programas bajo licencia no incluye leads de propietarios ni datos de cuentas de contratistas, y una posible coincidencia nunca debe describirse como dinero otorgado.
Por qué importa el objeto de vigencia
Una sola insignia de “verificado” ocultaría demasiado. Una URL puede responder mientras el importe guardado está desactualizado. Una revisión de fuente puede establecer la identidad del programa sin demostrar el importe. Una página puede bloquear la comprobación automatizada y seguir siendo útil para una persona. El contrato separa el estado del enlace, la fecha de la última comprobación, el alcance de confianza y la antigüedad de la revisión de la fuente para que una integración pueda adoptar un comportamiento conservador.
En un flujo dirigido al consumidor, descarte los enlaces que se sabe que están inactivos, muestre una cita disponible, marque como desconocidos los fondos que no se conocen y pida al usuario confirmar los datos que afecten una decisión. En análisis, conserve el estado del enlace y las fechas de revisión en la tabla derivada para que la antigüedad y la incertidumbre sigan siendo consultables.
Conserve la identidad exacta de la respuesta evaluada
Las respuestas correctas del contrato incluyen X-Request-ID y X-API-Version. Las respuestas correctas del conjunto también incluyen X-Dataset-Revision, que identifica la generación efectiva servida; no certifica que los registros sean completos, exactos ni adecuados para una decisión. Guarde estos valores con las notas de evaluación y los informes de corrección, nunca una clave de API sin cifrar.
La muestra pública, el esquema de un registro de la API, el esquema de una fila de exportación y el documento OpenAPI admiten ETag e If-None-Match. Las respuestas bajo licencia son privadas, usan no-store, varían según X-Api-Key y omiten ETags. El contrato para desarrolladores (en inglés) define la versión vigente, los insumos de la revisión, las reglas de identificadores de solicitud, las solicitudes condicionales y la política de retiro.
Qué debe responder una evaluación seria de 30 días
- ¿Cuánto tarda la primera solicitud exitosa y una integración básica?
- ¿El segmento propuesto de ciudades, categorías o audiencias contiene registros útiles?
- ¿Qué campos usa realmente el producto y cuáles faltan?
- ¿Cuántos registros revisados necesitan una corrección y qué consecuencias tienen los defectos?
- ¿El producto puede presentar citas e incertidumbre sin confundir al usuario?
- ¿Los eventos de cambios modifican un flujo derivado real?
- ¿Qué volumen anual y modelo de soporte necesitaría la producción?
Las claves de evaluación gratuita tienen un alcance intencionalmente limitado: vencen en un plazo máximo de 30 días y permiten de una a cinco ciudades activas aprobadas. Eso basta para evaluar el ajuste del producto sin presentar una prueba sin límites como una licencia de producción.
La oferta después de la evaluación
La hipótesis de oferta del piloto asistido es de $1,500 por 90 días, pero no está disponible mediante pago autoservicio. La disponibilidad del piloto queda en pausa hasta que se revisen el alcance y los términos de retención; una consulta no constituye aprobación ni una promesa de ofrecer el piloto. La hipótesis de oferta para organizaciones sin fines de lucro o académicas es de $2,000 al año, con revisión manual de la elegibilidad, los usuarios permitidos y el alcance de acceso, en vez de definirlos en este artículo. La hipótesis de oferta comercial anual es de $9,000 al año y solo puede usar pago autoservicio mientras el control de lanzamiento comercial publicado esté en verde. Los precios son ofertas que deben validarse, no evidencia de ajuste al mercado; los controles permanecen desactivados cuando sus condiciones no se cumplen.
Evalúe el producto, el contrato y la evidencia
Use primero el explorador de muestra y los inicios rápidos copiables. Luego solicite una evaluación limitada para un caso de uso definido y entre una y cinco ciudades.
Abrir el explorador de muestra Solicitar una evaluación (en inglés)Preguntas comunes
¿Qué ofrece la API de The Grant Map?
Registros estructurados de ayuda para reparar el hogar, organizados por ciudad, con campos publicados del programa, campos bilingües de descripción y etiqueta de importe, URL citadas, señales de vigencia y confianza con un alcance definido y un registro de cambios bajo licencia.
¿Decide si un propietario reúne los requisitos?
No. Es una capa de descubrimiento y orientación. La organización administradora decide la elegibilidad vigente, los fondos, las condiciones del beneficio, los plazos y la vía de solicitud.
¿Un comprador puede evaluarla sin una clave?
Sí. La muestra pública devuelve la colección dentro del alcance y sin registros en cuarentena para una ciudad de evaluación. La guía técnica, el esquema, el contrato OpenAPI, el resultado de salud de los datos y el resultado de preparación comercial también son públicos.
¿Todos los registros están verificados y vigentes?
No. La cobertura y la confianza varían, y los campos guardados pueden estar desactualizados o incompletos. Una URL que funciona no demuestra cada dato guardado. El producto expone evidencia y exclusiones conocidas para que un comprador pueda medir y manejar la incertidumbre en lugar de heredar una afirmación oculta.