Send episode number, title, and host details as JSON, get back a 1200x630 PNG for social posts.
Show producers and podcast networks use the podcast episode card API to ship a unique share card per episode rather than reusing the show cover. The 1200x630 ratio unfurls cleanly in Slack, Discord, X, and LinkedIn, and the layout reserves a slot for the show cover image so visual continuity with the directory listing stays intact. You post the episode number, title, duration, and host details as JSON, and the response holds a PNG ready to attach to a launch-day post or embed in the show notes.
Hosts publishing weekly episodes need fresh artwork for the launch-day social post. Trigger the render from your publishing pipeline (Buzzsprout, Transistor, Acast) on episode-published, attach the URL to the X and LinkedIn announcements, and the post lands with proper card art rather than a generic show graphic. The Production Hour ships every Tuesday with this exact flow, and the launch posts get 3x the engagement of the previous show-cover-only posts.
Show newsletters that link to the latest episode benefit from a per-episode card embedded in the email body. Render with the episode number, title, and host avatar, and subscribers can identify the episode at a glance before clicking through. Linden & Co's podcast network newsletter includes 8 episode cards per week (one per show), and the click-through rate beats the previous text-only template.
Show websites that publish each episode as a separate URL benefit from per-page OG images that show the actual episode rather than a generic show cover. Render once at publish time, set as og:image on the episode page, and shares from the directory unfurl with episode-specific artwork. Northwind Studio Audio serves 14 shows through this pattern.
Podcast networks running cross-promotion deals with adjacent shows benefit from episode cards that promote a guest appearance. Render with the partner show's branding and the cross-promo episode title, and both shows can share the card in their respective channels with consistent visuals. Halberd Software's cross-promo program runs through this template for 8 partner shows.
Agencies running podcasts on behalf of B2B clients deliver per-episode social cards as a standard deliverable. Render with the client's accent_color and host avatar, attach to the social calendar, and the agency ships consistent artwork across all client podcasts. Wren Analytics manages 6 client podcasts through this template, with 24 episode cards per month rendered in CI.
Matches the spec at 1.91:1 social share format (X, LinkedIn, Slack).
POST to the template endpoint with the values you want rendered. Authenticate with your API key.
The template is rendered server-side as a 1200x630 PNG.
Cache it, embed it in your page, attach it to an email.
A single cURL call to render a Podcast Episode Card as a PNG:
curl -X POST https://app.html2img.com/api/v1/templates/podcast-episode-card \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"episode_number":"042","episode_title":"How Riverside Bakery automated wholesale fulfillment","podcast_name":"The Production Hour","duration":"47 min","host_name":"Adaeze Okafor","host_avatar_url":"https://i.pravatar.cc/160?img=49","cover_image_url":"https://picsum.photos/seed/podcast-cover-card/600/600","accent_color":"#7C3AED"}'For the full PHP, Node and Python equivalents, plus every input the template accepts, see the Podcast Episode Card API reference. Setting up your key is covered in the authentication guide.
A 90-character title forces the renderer to scale type below the readable threshold for feed display. Trim to under 70 characters or rephrase into a punchy hook before posting, since the show notes page can carry the longer version.
One episode shows "47:00", the next "47 min", the next "0:47:30". The mixed format makes a series of cards look uneven. Standardize on one format ("47 min") and apply across all episodes so the show feed reads as one curated series.
A 404 on host_avatar_url falls back to a generic shape, which looks unfinished. Validate the avatar URL before posting, or supply a brand-safe fallback so the card never ships with a placeholder shape.
A quick summary of what the Podcast Episode Card template accepts. The full reference, with example values and array shapes, is in the docs.
| Name | Type | Required |
|---|---|---|
| episode_number | string | Required |
| episode_title | string | Required |
| podcast_name | string | Required |
| duration | string | Optional |
| host_name | string | Optional |
| host_avatar_url | url | Optional |
| cover_image_url | url | Optional |
| accent_color | string | Optional |
See the full inputs reference for descriptions, examples and validation rules.
25 renders a month on the free tier. See the pricing page for higher-volume plans.
