Hyvor Unfold

Hyvor Unfold is an open-source PHP library and self-hostable API for generating embed codes (Youtube, Twitter, and more) and fetching metadata from URLs for link previews.

Visit these pages to get started:

PHP Library: Use the PHP library in your PHP projects.
Docker Hosting: Run the API via Docker.

1. Embeds

Hyvor Unfold can convert URLs from various platforms to embed HTML codes.

Supported Platforms

Youtube: Videos, shorts, playlists, and channels
Facebook: Posts, pages, videos, and reels
Instagram: Posts and reels
Twitter/X: Tweets
Threads: Posts
Reddit: Posts and subreddits
Tiktok: Videos
Github: Gists
Bluesky OEmbed : Posts
Tenor OEmbed : GIFs
Giphy OEmbed : GIFs

When resolving embeds, we proritize regex-based methods to prevent needing to make API requests. If we can't resolve the embed using regex, we use OEmbed endpoints if available.

See our policy for adding new platforms.

2. Link Previews

You can also use Hyvor Unfold to fetch metadata from URLs. For example, you can use this to show a preview of a URL (called 'unfurled link').

When you request link data (via PHP or API), we send a GET request to the URL and parse the metadata from the HTML. This is done using the following:

<title> and <meta name="description"> tags for the title and description.
Open Graph Protocol tags
Twitter Cards Markup tags
JSON-LD and Microdata (Schema.org)