Website Flow
Integrate your locked podcast directly on your own website.
Users can listen to locked podcasts directly on your publisher website using private feeds and the podcast parsing API.
How It Works
If you use Sesamy authentication, you can:
- Use the
getAccessAPI to get the URL of the private feed - Pass it to the
parsePodcastAPI to get the show and episodes in JSON format - Render the podcast player on your website
Implementation
Using Sesamy Authentication
javascript
import { client } from '@sesamy/sdk';
// Initialize the SDK
const sesamyClient = client({
clientId: 'your-client-id',
});
// Get access to the private feed
const access = await sesamyClient.getAccess({
productId: 'your-podcast-product-id',
});
// Parse the podcast feed
const podcast = await sesamyClient.parsePodcast({
feedUrl: access.feedUrl,
});
// Use the podcast data to render your player
console.log(podcast.title);
console.log(podcast.episodes);Display Options
You have full control over how the podcast content is displayed on your website:
- Build a custom podcast player using the JSON data
- Create episode listings with play buttons
- Integrate with your existing audio player
- Show episode descriptions and metadata
Authentication Options
Sesamy Authentication
When using Sesamy's built-in authentication:
- Users log in through Sesamy
- Access is automatically validated
- Private feed URLs are generated per user
Custom Authentication
When using your own authentication system:
- Validate user subscriptions on your server
- Generate private feeds using the Sesamy API
- Pass feed URLs to your frontend
API Reference
| Endpoint | Description |
|---|---|
GET /access | Get access information including private feed URL |
GET /parse-podcast | Parse an RSS feed and return JSON |
See the API Reference for complete endpoint documentation.