Incrusta podcasts de Podhoc en tu web — Documentación del widget iframe

Incrusta tu podcast de Podhoc en cualquier web en segundos

Publicas un podcast en Podhoc. Lo quieres en tu blog, en un módulo de curso, en un artículo de redacción o dentro de la wiki de tu equipo. El embed de Podhoc es un único iframe — lo pegas, tu lector pulsa play y el audio se reproduce desde podhoc.com sin sacarlo de tu página.

Los permisos de incrustación son solo para el autor. Solo el autor del podcast puede generar un fragmento de incrustación para ese podcast — el botón Embed se controla en el servidor contra el owner_id del podcast y queda oculto en las fichas de Descubre de podcasts que no son tuyos. Así la atribución queda limpia y el autor mantiene el control sobre retiradas.

No hace falta cuenta para el oyente. Los lectores anónimos escuchan una previsualización gratuita de 30 segundos sin registrarse; al pulsar “Escuchar en Podhoc” se abre la página original donde pueden iniciar sesión para escuchar el episodio completo (los créditos se aplican según la matriz de créditos del Descubre). Las reproducciones de previsualización las absorbe Podhoc — no consumen tu saldo de créditos. El reproductor pesa 50 KB gzip, se carga en diferido al entrar en el viewport y muestra un placeholder de “no disponible” en vez de un frame roto si llegas a despublicar el podcast.

Cómo conseguir tu código de embed

1. Abre TU podcast en Descubre de Podhoc

Entra en app.podhoc.com/discover y abre uno de tus podcasts publicados. El botón Embed solo aparece en los podcasts que has creado tú, porque los permisos de incrustación están vinculados al autor; en las fichas de Descubre de podcasts que no son tuyos, el botón Embed queda oculto.

2. Pulsa Embed y copia el iframe

En la ficha del podcast pulsa Embed. Un modal te muestra el HTML del iframe ya cumplimentado con el slug canónico y el identificador único del permiso de incrustación. Copia el fragmento entero. El identificador de permiso es lo que Podhoc usa para atribuir las reproducciones de embed a tu cuenta y para gestionar retiradas; no lo elimines del fragmento.

3. Pega el iframe en tu sitio

Suelta el fragmento en cualquier bloque HTML — un widget HTML personalizado de WordPress, una tarjeta embed de Ghost, un /embed de Notion, una página MDX de Docusaurus, o <iframe> plano en un sitio estático. El reproductor sirve desde podhoc.com, se carga en diferido al entrar en el viewport y suma 50 KB gzip al peso de tu página.

Ejemplo: embed en vivo

Este es el fragmento canónico, apuntando a un podcast de muestra de Descubre. Sustituye el slug ?podcast=example por el de tu podcast tras el paso 2.

<iframe
  src="https://app.podhoc.com/embed?podcast=example"
  width="100%"
  height="240"
  loading="lazy"
  frameborder="0"
  allow="autoplay; clipboard-write; encrypted-media; picture-in-picture"
  title="Reproductor de Podhoc"
></iframe>

El atributo loading="lazy" no es negociable — mantiene el embed fuera de la ruta crítica de red hasta que el lector lo desplaza al viewport, que es lo que protege tu puntuación de page-speed.

Opciones de personalización

En v1 el iframe se entrega visualmente fijo a 100% de ancho × 240 px de alto con la paleta de marca de Podhoc. Estas palancas están en la hoja de ruta y se documentarán aquí cuando lleguen:

• Próximamente: ancho — un query param ?w= para sobrescribir el ancho por defecto del contenedor.
• Próximamente: alto — un query param ?h= para layouts compactos / expandidos.
• Próximamente: tema — ?theme=light|dark|auto para que combine con la paleta de tu sitio.

Hasta que aterricen, el embed es deliberadamente simple — un fragmento, sin ajustes, funciona igual en cada página.

Rendimiento

• Tamaño del bundle: 50 KB gzip para el primer embed de una página. Los siguientes embeds en la misma página solo añaden los metadatos del podcast (~2 KB cada uno), no el código completo del reproductor.
• Carga diferida: el iframe incluye loading="lazy" por defecto. El navegador retrasa la petición de red hasta que el lector lo desplaza al viewport, así que un embed bajo la línea de scroll cuesta cero bytes hasta que hace falta.
• Streaming: el audio se sirve desde la misma distribución de CloudFront que app.podhoc.com, con peticiones por rango de bytes para scrubbing instantáneo.
• Impacto en page-speed: en nuestras auditorías internas de Lighthouse, una página con un embed de Podhoc obtiene una puntuación a 1 punto de distancia de la misma página sin embed cuando el fragmento queda bajo la línea de scroll.

Anti-abuso — 100 reproducciones / día / host

Para mantener el streaming público sostenible sin facturártelo, Podhoc aplica un límite suave de 100 reproducciones por día y por host. El límite es por dominio que incrusta, no por podcast — si alojas diez embeds en miblog.example, todo el dominio comparte el presupuesto de 100 reproducciones diarias.

En la práctica:

• Las primeras 100 reproducciones del día se sirven con normalidad.
• A partir de ahí el reproductor sigue cargando y muestra los metadatos del podcast, pero presenta un mensaje amable de “Límite diario alcanzado — vuelve mañana o abrir en Podhoc”.
• El contador se reinicia a medianoche UTC.

Si tienes una necesidad legítima de un límite mayor (una redacción muy visitada, una plataforma de cursos con mucho tráfico), escríbenos desde la página de soporte — mantenemos una lista blanca para integradores de confianza.

Preguntas frecuentes

El bloque FAQ que aparece a continuación es el mismo que faqs: en el front-matter de la página, que es lo que Hugo emite como datos estructurados para los buscadores y los resúmenes de IA.

Relacionado

• Precios — packs de créditos y suscripciones (las reproducciones del embed no consumen tus créditos).
• Privacidad — qué registramos cuando un lector pulsa play en un embed.
• Términos — reglas de uso aceptable del widget embed.
• Descubre — explora podcasts públicos y copia códigos embed.

Explora Descubre y copia un código embed →