Preguntas Frecuentes

Beach Day API utiliza un sistema de créditos prepagados. Cada endpoint API cuesta un número determinado de créditos por llamada. Compras paquetes de créditos por adelantado y los créditos se deducen de tu saldo a medida que haces llamadas API. Cuando tu saldo llega a 0, las llamadas API devuelven un estado 402 hasta que compres más créditos.

We offer four credit packs: Starter (2,000 credits for $20, $0.01/credit), Pro (5,000 credits for $50, $0.01/credit), Business (22,000 credits for $200, $0.009/credit), and Scale (60,000 credits for $500, $0.008/credit).

Sí, los créditos caducan 1 año después de la compra. Recibirás un recordatorio por email cuando tu saldo esté bajo para que puedas planificar.

Regístrate para una cuenta gratuita y recibe 50 créditos de prueba gratis. Tu clave API se mostrará en tu panel. Usa el formato de autenticación Bearer token: Authorization: Bearer YOUR_API_KEY. Revisa la página de Documentación para la referencia completa de endpoints y ejemplos de código.

Cada cuenta nueva recibe 50 créditos gratis automáticamente al registrarse. Sin tarjeta de crédito. Con 50 créditos puedes hacer varias llamadas API para explorar los endpoints antes de comprar un paquete de créditos.

Las calificaciones de calidad del agua (A a F) se basan en datos de concentración bacteriana de programas gubernamentales de monitoreo de playas, incluyendo los reportes EPA BEACH Act. Grado A = excelente, por debajo de 35 CFU/100mL. Grado F = inseguro para nadar.

Beach Day API cubre más de 36,000 playas en 110 países: Estados Unidos (5,034 playas en los 50 estados + DC, incluyendo playas costeras, de los Grandes Lagos y de lagos interiores), Reino Unido (1,085 playas), España (3,145), Italia (3,495), Francia (3,965), Croacia (981), Grecia (2,595), Malta (33), Chipre (106), Turquía (442), Portugal (658), Japón (453), Filipinas (335), Corea del Sur (249), México (277), Costa Rica (182), Cuba (193), República Dominicana (98), Puerto Rico (129), Jamaica (41), Bahamas (56), Panamá (60), India (543 playas en 11 estados costeros), Indonesia (329), Australia (2,378), Nueva Zelanda (1,130), Chile (979), Noruega (485), Suecia (464), Dinamarca (218), Alemania (605), Polonia (299), Estonia (354), Países Bajos (211), Bélgica (64), Letonia (33), Lituania (25), Irlanda (325), Albania (97), Montenegro (99), Islandia (4), Malasia (87), Sri Lanka (61), Taiwán (55), China (709), Nueva Caledonia (111), Seychelles (146), Marruecos (168), Gabón (54), más Polinesia Francesa, Fiyi, Tailandia, Camboya, Vietnam, Barbados, Maldivas, 8 naciones insulares del Pacífico, 8 países centroamericanos y 36 países africanos. Filtra por país con ?country=Marruecos o descubre todos los países con GET /v1/countries.

Sí. Cubrimos más de 2,100 playas en España con datos del sistema de vigilancia de aguas de baño NÁYADE (Ministerio de Sanidad). La cobertura incluye todas las comunidades autónomas costeras: Andalucía, Cataluña, Comunidad Valenciana, Galicia, Islas Baleares, Canarias, País Vasco y más. Usa el parámetro de consulta state con ES-AN (Andalucía), ES-CT (Cataluña), ES-IB (Islas Baleares) o ES-VC (Comunidad Valenciana) para filtrar playas españolas.

Las llamadas API devolverán HTTP 402 Payment Required con un cuerpo JSON que indica tu saldo actual y los créditos requeridos. Tu integración debe manejar las respuestas 402 alertando al usuario o pausando las llamadas API hasta que se compren créditos.

No. El procesamiento de pagos lo maneja completamente Stripe. Beach Day API nunca ve ni almacena los datos de tu tarjeta. Solo recibimos una confirmación de Stripe cuando se completa un pago.

Sí. Hay librerías cliente oficiales para Python y Node.js:

Python: pip install beachdayapi
Node.js: npm install beachdayapi

Ambas son envoltorios sin dependencias alrededor de la API REST. Consulta la documentación para ejemplos de uso.

Sí. Beach Day API está disponible como integración de Zapier (beta). Conecta datos de playas a Slack, Gmail, Google Sheets y más de 9,000 apps sin escribir código.

Acciones disponibles: Consultar Condiciones de Playa (calidad del agua actual, clima, condiciones oceánicas y mareas), Consultar Puntuación de Playa (puntuación y calificación), Buscar Playas (encuentra playas por nombre).

Para usarla, ve a la página de Beach Day API en Zapier y haz clic en Probar. Necesitarás tu clave API del Panel.

Sí. Cubrimos playas en 17 estados costeros de Brasil — desde Amapá en el norte hasta Rio Grande do Sul en el sur, incluyendo Río de Janeiro, São Paulo, Bahía, Pernambuco y Fernando de Noronha.

Los datos de ubicación de playas provienen de OpenStreetMap, con condiciones meteorológicas y oceánicas (altura de olas, temperatura del agua) de Open-Meteo. Usa el parámetro de consulta country (?country=Brazil) o filtra por códigos de estado como ?state=BR-RJ (Río de Janeiro), ?state=BR-SP (São Paulo) o ?state=BR-BA (Bahía).

Cubrimos más de 5,034 playas en los 50 estados de EE.UU. más DC, incluyendo playas costeras, de los Grandes Lagos y de lagos interiores. La cobertura incluye:

Costa Oeste: California (317+), Oregón (50+), Washington (148+) — 515+ en total
Costa Atlántica: Maine (127+), Nuevo Hampshire (6+), Massachusetts (382+), Rhode Island (33+), Connecticut (49+), Nueva York (424+), Nueva Jersey (113+), Delaware (7+), Maryland (56+), Virginia (71+), Carolina del Norte (43+), Carolina del Sur (55+), Georgia (30+), Florida Atlántica (57+) — 1,453+ en total
Costa del Golfo: Florida Golfo (57+), Alabama (18+), Misisipi (11+), Luisiana (18+), Texas (39+) — 143+ en total
Grandes Lagos: Pensilvania (64+), Ohio (59+), Míchigan (287+), Indiana (59+), Illinois (101+), Wisconsin (130+), Minnesota (124+) — 824+ en total
Lagos Interiores: Vermont (50+), Misuri (45+), Virginia Occidental (33+), Tennessee (29+), Iowa (30+), Arkansas (25+), Nevada (24+), Idaho (19+), Nebraska (15+), Kentucky (13+), Colorado (12+), Arizona (12+), Utah (11+), Dakota del Sur (12+), Oklahoma (8+), Montana (6+), Kansas (14+), más el Lago Tahoe, Lago Havasu, Lago Mead, Lago de los Ozarks y muchos más — 380+ en total
Pacífico: Hawái (189+), Alaska (29+) — 218+ en total

Todas las playas de EE.UU. incluyen datos meteorológicos actuales. Usa el parámetro de consulta state con códigos de estado de EE.UU. (ej., ?state=CA para California, ?state=MO para playas de lagos de Misuri) para filtrar.

Sí. Además de nuestra cobertura costera, Beach Day API cubre playas de lagos interiores en los 50 estados de EE.UU. y áreas internacionales de natación recreativa en 11 países.

Estados Unidos: Lago Tahoe (CA/NV), Lago de los Ozarks (MO), Lago Havasu (AZ/CA), Lago Mead (NV/AZ), Lago George (NY), Lago Winnipesaukee (NH), Lago Champlain (VT/NY), Lagos Norris y Douglas (TN), Lago Table Rock (MO), Lago Cumberland (KY), Lago Lanier (GA), Lago Murray (SC), Lago Crab Orchard (IL), Lago Bear (UT) y cientos de playas de parques estatales y áreas recreativas en los 50 estados.

Internacional: Noruega (lugares de natación en lagos), Suecia (natación en lagos), Francia (áreas de baño designadas), Reino Unido (natación en lagos y aguas abiertas), Italia (lidos y playas recreativas), Japón (áreas de natación), Australia (piscinas oceánicas y pozas) y más.

Cada playa incluye datos meteorológicos actuales y una Puntuación Beach Day. Filtra por país y estado (ej., ?state=MO para playas de lagos de Misuri o ?country=Noruega para playas noruegas).

Sí. Cubrimos playas en 6 departamentos costeros — Colonia, San José, Montevideo, Canelones, Maldonado (Punta del Este) y Rocha.

Los datos de ubicación de playas provienen de OpenStreetMap, con condiciones meteorológicas y oceánicas (altura de olas, temperatura del agua) de Open-Meteo. Usa el parámetro de consulta country (?country=Uruguay) o filtra por códigos de estado como ?state=UY-MO (Montevideo), ?state=UY-MA (Maldonado) o ?state=UY-RO (Rocha).

Sí. Cubrimos playas en la costa pacífica de Ecuador — Esmeraldas, Manabí, Guayas, Santa Elena, El Oro — además de las Islas Galápagos.

Los datos de ubicación de playas provienen de OpenStreetMap, con condiciones meteorológicas y oceánicas (altura de olas, temperatura del agua) de Open-Meteo. Usa el parámetro de consulta country (?country=Ecuador) o filtra por códigos de estado como ?state=EC-W (Galápagos), ?state=EC-M (Manabí) o ?state=EC-E (Esmeraldas).

Sí. Cubrimos los 4,270 km de costa de Chile en 7 macrozonas — desde Arica en el norte hasta Tierra del Fuego en el sur, además de Isla de Pascua (Rapa Nui) y el archipiélago Juan Fernández.

Los datos de ubicación de playas provienen de OpenStreetMap, con condiciones meteorológicas y oceánicas (altura de olas, temperatura del agua) de Open-Meteo. Usa el parámetro de consulta country (?country=Chile) o filtra por códigos de estado como ?state=CL-CE (Chile Central), ?state=CL-MA (Magallanes) o ?state=CL-EA (Isla de Pascua).

Sí. Cubrimos playas en la costa pacífica de Perú — desde las playas del norte de Tumbes y Piura, pasando por Lima, hasta Tacna en el sur.

Los datos de ubicación de playas provienen de OpenStreetMap, con condiciones meteorológicas y oceánicas (altura de olas, temperatura del agua) de Open-Meteo. Usa el parámetro de consulta country (?country=Peru) o filtra por códigos de estado como ?state=PE-CE (Central / Lima), ?state=PE-NO (Norte) o ?state=PE-SU (Sur).