Reports API - 16 informes PDF listos con tu marca

Envías una fecha de nacimiento y recibes un documento listo. No un JSON a partir del cual debas maquetar un PDF, sino el PDF mismo: maquetado página por página, con tu logotipo, el nombre de tu informe y sin ninguna mención nuestra dentro.

Dieciséis de estos informes ya están funcionando. Junto con el despachador, el historial de exportaciones y cinco narrativas de IA, esto suma 23 rutas bajo /v1/reports/*.

Catálogo

Cada fila tiene una muestra lista. Esto no es un diseño: el archivo se genera con la misma llamada que se imprime en la referencia de este endpoint, y se vuelve a emitir junto con las plantillas.

El número de páginas es el que dio esta muestra, medido el 2026-09-21. Varía según la carta: más aspectos significan más líneas, y relocation añade dos o tres páginas por cada ciudad (4 páginas para una ciudad, 13 para cinco).

Endpoint	Contenido	Páginas	Créditos	Muestra
/v1/reports/natal	La Gran Tríada, planetas, casas, aspectos	3	5 000	PDF
/v1/reports/synastry	Aspectos inter-carta de dos cartas, equilibrio de elementos	2	5 000	PDF
/v1/reports/transit-yearly	Pronóstico de tránsitos para el año seleccionado	5	5 000	PDF
/v1/reports/relocation	Carta natal, hasta 5 ciudades, planetas que cambiaron de casa, líneas cercanas, 19 áreas de la vida	6	5 000	PDF
/v1/reports/vedic-kundli	Lagna y nakshatra, posiciones siderales, mahadashas Vimshottari	2	5 000	PDF
/v1/reports/lal-kitab	Kismat, tewa, rinas detectadas, upayas	2	5 000	PDF
/v1/reports/gemstone	Recomendación de gemas con mantras, gemas que no debes usar, estado de los grahas	7	5 000	PDF
/v1/reports/human-design	Parámetros clave, centros, canales	2	5 000	PDF
/v1/reports/muhurta	Días propicios clasificados para una actividad	4	5 000	PDF
/v1/reports/love	Puntos clave del amor, la Gran Tríada, aspectos	2	5 000	PDF
/v1/reports/career	Puntos clave de la carrera, contexto de la personalidad, aspectos	2	5 000	PDF
/v1/reports/money	Puntos financieros clave, casas, aspectos	3	5 000	PDF
/v1/reports/business	Puntos clave del negocio, casas, aspectos	2	5 000	PDF
/v1/reports/child	Rasgos clave de carácter, la Gran Tríada, planetas	2	5 000	PDF
/v1/reports/stellaforge	Póster de carta en una página: planetas, equilibrio, aspectos clave	1	5 000	PDF
/v1/reports/tarot	Descripción de la tirada y las cartas	2	100	PDF
/v1/reports/vastu	Plano de casa con mandala, evaluación, hallazgos de Vastu con fuentes y correcciones	2	5 000	PDF

El Tarot cuesta cincuenta veces menos porque no hay efemérides: una página de tirada sin cálculos astronómicos.

Profundidad: standard o extended

/v1/reports/natal (y /v1/reports/generate con report_type: "natal") acepta depth. standard es el documento anterior, 5000 créditos. extended cuesta 10000 créditos y añade la rueda de la carta y una sección para cada cuerpo desde el Sol hasta Plutón, Quirón y el Ascendente en el signo: doce secciones, cada una de dos a cuatro páginas de texto editado (muestra PDF, 13 páginas) del mismo corpus que devuelve /v1/natal-texts. Nada se genera bajo demanda, por lo que la misma carta produce el mismo documento.

Las secciones están disponibles en 20 idiomas, los idiomas del sitio; depth: "extended" con un idioma diferente se rechaza con un 400, en lugar de rellenarse con otro idioma. Otros tipos de informes por ahora tienen una sola profundidad: sus secciones largas aún no han sido escritas.

Una ruta en lugar de dieciséis

POST /v1/reports/generate acepta el campo report_type y hace lo mismo que una ruta separada. Doce tipos: natal, transit-yearly, synastry, business, career, love, money, child, lal-kitab, human-design, tarot, vedic-kundli.

Para el SDK, es un método en lugar de doce; para MCP, una herramienta en lugar de doce. El precio es el mismo: una llamada a través del despachador consume exactamente lo mismo que una ruta directa.

PDF o HTML

Por defecto, se recibe un PDF y un enlace al mismo. ?format=html devuelve una página HTML lista directamente en la respuesta, sin renderizado ni almacenamiento: conveniente cuando incrustas el informe en tu página o quieres aplicar tu propio CSS.

El enlace al PDF es válido por 24 horas. Para entregar al cliente un enlace por más tiempo, añade ?retain_days=30 (hasta 90): el archivo permanecerá tantos días, y expires_at en la respuesta lo indicará. No alojamos documentos de terceros indefinidamente, y puedes eliminar un archivo antes a través de DELETE /v1/reports/files/{filename}, de forma gratuita. El archivo contiene lo que enviaste, junto con el nombre, por lo que el período de retención se describe en el DPA, sección 2. GET /v1/reports/history muestra gratuitamente las últimas exportaciones de esta clave, y un registro caducado viene con expired: true.

Tu marca, no la nuestra

whitelabel acepta un objeto con 15 campos: companyName, companyUrl, companyEmail, companyMobile, companyBio, logoUrl, frontImage, reportName, footerText, fontPairing y cinco colores (themeColor, headingColor, textPrimaryColor, textSecondaryColor, backgroundColor).

Puedes pasarlo directamente en la solicitud, y entonces no se necesita ninguna configuración de cuenta:

curl -X POST https://api.astroway.info/v1/reports/natal \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "chart": { "date": "1990-05-15", "time": "14:30:00",
                   "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52 },
        "whitelabel": { "companyName": "Zoryana Studio",
                        "reportName": "Your Birth Blueprint",
                        "themeColor": "#7c3aed",
                        "footerText": "zoryana.example" } }'

En el documento generado, verás el nombre del estudio, tu propio título de informe, el color de acento en los encabezados de las secciones y tu pie de página. La palabra AstroWay no aparece ni una sola vez.

Una alternativa para quienes no quieren repetir el objeto en cada solicitud: whitelabel: true toma la configuración de cuenta guardada. Defínela en la página Branding de informes en el panel de control: nombre de la empresa, nombre del informe, contactos, logotipo y dos colores, con una vista previa de un informe natal de ejemplo. Las mismas configuraciones están disponibles con la clave a través de /v1/whitelabel/config y /v1/whitelabel/logo, y POST /v1/whitelabel/preview dibuja una muestra en PDF. Un campo pasado en el objeto tiene prioridad sobre el guardado.

Aplicación lista para clonar

Demo en vivo y código en GitHub, MIT.

Mesa de práctica: datos del cliente a la izquierda, PDF listo a la derecha. Cada tarjeta de informe muestra el precio en créditos antes de hacer clic y lleva a una muestra lista. El white-label se activa con una casilla de verificación. El backend es una única ruta sin dependencias, porque ahí radica la esencia: el navegador no puede acceder directamente a la API, por lo que la clave reside en el servidor.

git clone https://github.com/astroway/starter-practice
cd starter-practice && npm install
cp .env.example .env     # your key goes here
npm run dev

Cuatro cosas que vale la pena destacar. El precio se muestra donde se toma la decisión: el servidor devuelve X-Credits-Used a la página, no solo al registro. Dieciséis informes tienen cuatro formularios de solicitud, no dieciséis. La misma solicitud por segunda vez cuesta cero, porque la caché de respuestas devuelve el mismo archivo. Y ALLOWED_REPORTS limita lo que la instancia aceptará renderizar: la demo pública solo renderiza la tirada de Tarot (/v1/reports/tarot, 100 créditos), porque una página en internet abierta que genera un informe natal (/v1/reports/natal, 5 000) para cualquiera, agota el límite mensual gratuito en dos clics.

Idiomas

El campo language acepta 21 códigos. Tres están completamente traducidos: ucraniano, inglés, ruso. Para los dieciocho restantes, se localizan los nombres de los signos, pero los títulos y explicaciones permanecen en inglés: un informe en alemán escribirá “Löwe” bajo el título “Planets”.

Lo decimos directamente, porque el informe es un documento que tu cliente se queda. Venderlo como alemán, viendo los nombres de los signos en alemán en el ejemplo, sería un descubrimiento desagradable para el cliente, no para nosotros. El informe muhurta es completamente en inglés por ahora.

Precaución

Medido el 2026-09-20. Si necesitas un idioma específico completamente, escríbenos: la cola de traducciones manuales avanza por demanda, no por lista.

Cuántos informes se obtienen con el plan

/v1/reports/natal y el resto de los PDF cuestan 5 000 créditos, por lo que el límite mensual del plan se traduce simplemente en el número de informes:

Plan	Créditos/mes	Informes PDF	Informes de Tarot
Free	10 000	informes no disponibles	no disponibles
Indie, $5	50 000	10	500
Starter, $19	200 000	40	2 000
Pro, $59	800 000	160	8 000
Business, $199	3 500 000	700	35 000
Reports Pack, $99	1 500 000	300	15 000

En Free, los informes están cerrados intencionadamente: un PDF son segundos de trabajo de Chrome de nuestra parte, y la tarifa gratuita no los cubre. La entrada más barata es Indie por $5.

Reports Pack es un complemento separado para aquellos que solo necesitan informes: $99 al mes, 1 500 000 créditos, es decir, 300 PDF a 33 centavos cada uno, con white-label. Esto es más barato por PDF que en Pro, porque la clave no va a ninguna parte excepto a los informes. Una clave de este plan solo funciona en /v1/reports/* y /v1/whitelabel/*.

Reventa de informes: cuánto te cuesta un PDF

Si vendes informes a tus clientes, un número es clave: cuánto te cuesta un PDF en tu volumen. Dentro del límite del plan, es el precio del plan dividido por el número de PDF. Por encima del límite, cada PDF se considera un excedente, que se calcula por cada 10 000 créditos por encima del límite, por lo que un PDF de 5000 créditos cuesta la mitad de la tarifa de excedente del plan.

Plan	PDF en el plan	Precio del PDF dentro del límite	Cada PDF extra
Indie, $5	10	$0.50	$2.50
Starter, $19	40	$0.48	$2.50
Pro, $59	160	$0.37	$1.50
Reports Pack, $99	300	$0.33	$1.50
Business, $199	700	$0.28	$1.00

Así, el plan más barato depende de cuántos PDF vendas al mes, incluyendo el excedente:

PDF al mes	Plan más barato	Tus gastos	Por PDF
10	Indie	$5	$0.50
40	Starter	$19	$0.48
100	Pro	$59	$0.59
160	Pro	$59	$0.37
300	Reports Pack	$99	$0.33
500	Business	$199	$0.40
700	Business	$199	$0.28

Puntos de cambio: Starter es más rentable que Indie a partir de 16 PDF, Pro que Starter a partir de 57, Reports Pack que Pro a partir de 187, si no necesitas nada más que informes, Business que Reports Pack a partir de 367. Pro y Business también abren el resto de la API, Pack solo informes y white-label.

Tú estableces el margen. Con 300 PDF en Reports Pack, tus gastos son $99 al mes. A $9 por unidad, son $2700 de ingresos frente a $99 de gastos; a $19, son $5700. No recomendamos un precio minorista, pero la aritmética es la misma para cualquiera: tu precio menos 33 centavos.

El informe natal extendido cuesta el doble que el estándar, por lo que en cada plan superior es el doble del precio por PDF: $0.66 en Reports Pack.

Dos cosas más reducen los costos reales. Una solicitud repetida con los mismos datos devuelve el mismo archivo de la caché de respuestas y no cuesta nada, por lo que un cliente que descarga un informe dos veces se paga una sola vez. Y un plan anual son 12 meses por el precio de 9, y Reports Pack sale a $0.25 por PDF.

Antes de vender, abre las muestras: cada una es exactamente el archivo que devuelve la API, y con whitelabel tu nombre y colores ocupan el lugar de los predeterminados.

Si necesitas texto, no un documento

Cinco endpoints devuelven una narrativa de IA como JSON, sin maquetación y sin PDF: /v1/reports/ai/natal-narrative, /transit-narrative, /synastry-narrative, /year-ahead-narrative, /monthly-narrative. Por 250 créditos. Úsalos cuando el texto vaya a tu propio diseño, aplicación o boletín.

El informe natal también tiene un modo mixto: enrich: true añade la narrativa de IA dentro del PDF. En la misma carta de prueba, esto son 5 páginas en lugar de 3.