Auto Audio API

Automatically convert web content to audio

Transform any article or webpage into high-quality, professionally narrated audio with a single API call.

Overview

The Auto Audio API enables automatic conversion of web articles into high-quality audio content. Simply provide a URL, and the system will extract content, generate professional narration, apply audio mixing, and return an embeddable audio player.

Universal Compatibility

Works with any public URL. Automatic content extraction from any website.

Multi-Language

Automatic language detection with support for 11+ languages.

Audio Mixing

Professional background music, intro/outro support, and audio polish.

Smart Caching

Instant retrieval of previously converted articles with automatic update detection.

Conversation Mode

Multi-voice narration for engaging audio experiences.

CMS Integration

Native support for Fusion, NEXT_DATA, and Brightspot structured data.

Base URL: https://creator.everlit.audio

Quick Start: For step-by-step implementation guides, see Web Integration (websites & CMS) or Mobile Integration (native apps).

Usage

The simplest way to add Everlit Auto Audio to your website is by including a widget container and the JavaScript SDK. The widget will automatically detect content on your page and convert it to audio.

Basic Implementation

Add the following HTML to your page where you want the audio player to appear:

<!-- 1. The widget container -->
<div
  id="everlit-auto-audio-widget"
  data-publication-id="YOUR-PUBLICATION-ID"
  style="height: 136px; width: 100%;"
  hidden
><a href="https://everlit.audio/" rel="nofollow">Listen to this article &mdash; audio by Everlit</a></div>

<!-- 2. The script -->
<script
  defer
  src="https://cdn.everlit.audio/libs/everlitAutoAudio.js"
  type="text/javascript"
></script>

Widget v2 (2026-09-02): the snippet above is unchanged. Version 2 of everlitAutoAudio.js moves everything it exposes under the shared window.Everlit namespace and adds a status field to every response. See Widget v2.

Widget Container

Attribute	Required	Description
`id`	Yes	Must be `everlit-auto-audio-widget`
`data-publication-id`	Yes	Your unique Everlit publication ID (e.g., `pblc_abc123xyz`)
`hidden`	Recommended	Hides the container until audio is ready
`style`	Optional	Set dimensions; recommended height is `136px`
Fallback link	Recommended	The link inside the container is never shown to visitors — it is replaced by the player (or stays hidden). It gives non-JavaScript crawlers a text fallback and is automatically excluded from audio conversion.

Script Tag

Attribute	Description
`defer`	Loads the script without blocking page rendering
`src`	Always use `https://cdn.everlit.audio/libs/everlitAutoAudio.js`
`data-everlit-host`	Optional, advanced. Overrides the API origin the widget talks to. Defaults to `https://creator.everlit.audio` — leave it off unless Everlit support has given you a different host. See API host.

API Host (advanced)

By default the widget calls https://creator.everlit.audio. If Everlit support has given you a dedicated or regional host, set data-everlit-host on either the script tag or the widget container — the script tag wins if both are present.

<script
  defer
  src="https://cdn.everlit.audio/libs/everlitAutoAudio.js"
  data-everlit-host="https://creator.everlit.audio"
  type="text/javascript"
></script>

<!-- or on the container -->
<div
  id="everlit-auto-audio-widget"
  data-publication-id="YOUR-PUBLICATION-ID"
  data-everlit-host="https://creator.everlit.audio"
></div>

Rule	Behaviour
Default	`https://creator.everlit.audio` when the attribute is absent, empty, or invalid
Scheme	Only `http:` and `https:` origins are honoured; anything else falls back to the default
Trailing slash	Ignored — `https://host/` and `https://host` are equivalent
Resolved value	Readable at runtime as `window.Everlit.autoAudio.host`

That's it! Once added, the widget will automatically detect your page's content, check for existing audio, and display the player when available. The hidden attribute is automatically removed when the player is ready.

How It Works

When the script loads, it will:

Detect the canonical URL of your page
Check if audio already exists for this content
If audio exists, display the embedded player
If not, display a click-to-create widget (if enabled for your publication)
Dispatch JavaScript events for each state change

Need your Publication ID? Contact Everlit support to obtain your credentials.

Best Practices

Place the widget container early in your article template for best visibility
Use the hidden attribute to prevent layout shifts before audio loads
Set a fixed height (136px recommended) to reserve space for the player

Performance Tips

Use the defer attribute on the script tag to avoid blocking page load
The widget automatically caches results - repeated page loads are instant
Consider using the JavaScript events to lazy-load related UI elements

Content Optimization

Ensure your pages have a valid canonical URL for consistent audio matching
Use semantic HTML to help content extraction identify article body text
Include proper meta tags (title, description, author) for better audio metadata

Error Handling

Listen for the everlit:error event to gracefully handle failures
Implement retry logic with exponential backoff for transient errors
Use the check endpoint for status polling rather than repeatedly calling the POST endpoint

Pro tip: Combine the everlit:ready event with your analytics to track audio engagement alongside article pageviews.

Support & Resources