Embed
DocsGuidesEmbed

Embed

Paste one tag and Spoken’s scan runs inside your page. No backend, no user accounts to build.

The tag

HTML
<script src="https://spoken.fyi/embed.js" data-key="pk_live_…"></script>
<div id="spoken-scan"></div>

<script>
  document.querySelector("#spoken-scan").addEventListener("spoken:build", (e) => {
    // e.detail = { id, url } — link to the build, or keep the id
  });
</script>

The key is a publishable key (pk_live_…). It is safe in a web page because it can only open the embed. Your page hears two events on #spoken-scan: spoken:build when a build is finished and spoken:height as the frame resizes.

What your visitor gets

They scan as a guest, then verify a phone number to keep the build. The build is theirs on spoken.fyi, with its posters and film. Your site never receives their phone number. You are billed per completed scan.

Set it up

In the console under Embed: create the publishable key, list the domains allowed to show the embed, and see it live on a phone and a laptop before you paste it.