PEACHIFY API
Embed any movie or TV episode with one URL. No key, no signup, no SDK — the link is the API, and the player is the response. Build the URL below, copy the snippet, and it plays.
Embed Movies
TMDB IDs only — open the film on themoviedb.org and copy the number from its URL. IMDb IDs do not work here: TMDB and IMDb numbering are different.
https://peachify.net/embed/movie/{tmdb_id}
Embed Shows
TMDB ID plus season and episode, both plain integers starting at 1. Change the last number for the next episode, the middle one for the next season.
https://peachify.net/embed/tv/{tmdb_id}/{season}/{episode}
Interactive Builder
Basic settings
Find the ID on themoviedb.org — it is the number in the title's URL. Movies need nothing else; TV needs a season and an episode.
Colors
Default
Netflix
Discord
Spotify
Twitch
Orange
The accent colours the border of the embed wrapper in your snippet and the preview frame below — your page, your frame.
Features & controls
Allow fullscreen
allowfullscreen attribute
Allow picture-in-picture
allow attribute
Lazy loading
loading="lazy" attribute
16:9 responsive wrapper
aspect-ratio wrapper div
Every switch changes the snippet below. Nothing here is decoration — if a switch is on, its attribute is in the code you copy.
https://peachify.net/embed/movie/533535
↗ OPENLive preview — the same player your visitors get. The URL you copy is the clean embed link.
Integration Code
The snippet follows the builder above — change the ID, the type, or any switch, and the code updates with it. Paste it where the player should sit; the wrapper keeps it 16:9 on any screen.
One note: the snippet embeds a player page, so it works in any framework that can render an iframe — React, Vue, Next.js, Angular, or plain HTML. There is no SDK to install and no JavaScript API to initialise.
DOCUMENTATION REFERENCE
Every parameter the embed actually takes — path, query, and iframe attribute.
Embed Parameters
Title ID
The TMDB ID of the title, in the URL path. It is the number in the title's themoviedb.org URL — for a movie it is the whole request, for TV it is the first of three numbers.
https://peachify.net/embed/movie/533535
TV Season
The season number for a TV episode, in the URL path after the ID. A plain integer starting at 1. Only used for TV — movies have no season, and a season that does not exist will not play.
https://peachify.net/embed/tv/1399/1/1
TV Episode
The episode number for a TV episode, in the URL path after the season. A plain integer starting at 1. Change this number alone to move to the next episode in the same season.
https://peachify.net/embed/tv/1399/1/2
Preview Flag
Tester-only flag. The homepage preview adds it, and it only takes effect when the page embedding it is peachify.net itself. Put it on your own site and the player ignores it.
https://peachify.net/embed/movie/533535?demo=1
Fullscreen
An iframe attribute, not a URL parameter. Put it on the iframe and the player's fullscreen button works; leave it off and the button does nothing. Every snippet the builder makes includes it unless you switch it off.
allowfullscreen
Permissions
The iframe permissions attribute. The builder's version allows autoplay, fullscreen, and picture-in-picture — the three the player uses. Restrict it and the matching player feature stops working.
allow="autoplay; fullscreen; picture-in-picture"
Lazy Loading
An iframe attribute for list pages. With it, an off-screen embed loads only when the visitor scrolls to it — a page with fifty episode links stays as fast as a page with one. The builder adds it only when you switch it on.
loading="lazy"
Referrer Policy
An iframe attribute that controls what the browser sends as the referrer. Use strict-origin-when-cross-origin — the player uses the referrer to tell a real embed from the homepage demo, and a policy of no-referrer breaks that check.
referrerpolicy="strict-origin-when-cross-origin"
That is the whole parameter list. The embed URL takes no other query parameters — there is no server picker, no subtitle or audio parameter, and no autoplay flag on the URL itself, because the player reads the title from the path and handles quality and subtitles on its own. If a parameter is not on this page, the player does not accept it.
Troubleshooting & Limits
A link that does not play is almost always one of three things — the ID, the episode numbers, or the source itself. The demo is the diagnostic: if it plays in the live demo, the link is fine and the problem is on the page around it.
Wrong ID
A wrong digit, a year, or an IMDb ID in place of the TMDB ID. Open the title on themoviedb.org and copy the number again — the ID is the number in the URL, not the year and not the IMDb tt-number.
Season or episode doesn't exist
Season and episode both start at 1, and a season that does not exist will not play. Check the episode list on themoviedb.org before blaming the link.
The source is gone
Peachify aggregates publicly available sources, and a source that disappears takes its title with it. Try the same link in the live demo to see whether the link or the page is at fault.
Free because it's ad-supported
Ads run on embeds, and that is how Peachify pays for itself. There is no paid tier that removes them.
No metadata endpoint
The API returns a player, not JSON about a title. Posters, plots, cast, and ratings belong to TMDB's own API, which is built for metadata — Peachify answers one question only: play this title, now.
No media files
Peachify does not host, store, or manage any media files. The player aggregates publicly available sources and routes them by TMDB ID, so it is the wrong tool for a site that needs its own files, encoding, or DRM.
Integrate with AI
Building a site? Copy this markdown and paste it into ChatGPT or Cursor. It is framed from the developer's perspective and contains the entire API schema, so the AI can write your integration component for you instantly.
# Peachify API — integration notes for AI
Peachify is a free movie & TV embed API. No API key, no signup, no SDK.
Base: https://peachify.net
## Endpoints
- Movie: https://peachify.net/embed/movie/{tmdb_id}
- TV episode: https://peachify.net/embed/tv/{tmdb_id}/{season}/{episode}
## Rules
- IDs are TMDB IDs (numbers from themoviedb.org). IMDb IDs do not work.
- Season and episode are integers starting at 1.
- The API returns a player page, not JSON. Embed it in an iframe.
- Free because the player is ad-supported. Ads run on embeds.
- No metadata endpoint — use TMDB's API for posters, plots, cast.
- Peachify hosts no media files; sources are aggregated publicly.
## Embed (HTML)
<iframe src="https://peachify.net/embed/movie/533535" style="width:100%;aspect-ratio:16/9;border:0" allow="autoplay; fullscreen; picture-in-picture" allowfullscreen></iframe>Questions, answered
The same answers live in the page's FAQ schema, so Google can show them right in search results.
See it play before you ship it
Type any TMDB ID into the live Peachify player on the homepage. It takes ten seconds, it costs nothing, and there is no signup standing between you and play.
▶ Open the live playerFree to try · No account · Movies & TV