OEmbed 1.0.1

.NET 6.0 This package targets .NET 6.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package OEmbed --version 1.0.1
                    


                    

                
NuGet\Install-Package OEmbed -Version 1.0.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="OEmbed" Version="1.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="OEmbed" Version="1.0.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="OEmbed" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add OEmbed --version 1.0.1
                    


                    

                
#r "nuget: OEmbed, 1.0.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package OEmbed@1.0.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=OEmbed&version=1.0.1
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=OEmbed&version=1.0.1
                    


                            Install as a Cake Tool

OEmbed

A simple oEmbed consumer library for .NET

Install

via NuGet:

PM> Install-Package OEmbed

DI extensions for Microsoft.Extensions.DependencyInjection:

PM> Install-Package OEmbed.Extensions.Microsoft.DependencyInjection

DI configuration

services.AddOEmbed();

// or

services.AddOEmbed(options =>
{
  options.EnableCache = true; // true by default
});

By default it's register all built in providers:

  • InstagramProvider
  • TiktokProvider
  • TwitterProvider
  • VimeoProvider
  • YoutubeProvider

You can add a provider during configuration:

services.AddOEmbed()
  .ClearProviders() // remove all default providers
  .AddProvider<YoutubeProvider>()
  .AddProvider<VimeoProvider>();

Usage

  • Inject IOEmbedConsumer throught constructor injection.
  • Call one of RequestAsync() overloads.

For example:

using HeyRed.OEmbed.Abstractions;
using HeyRed.OEmbed.Models;

// Returns null if provider not found for given url
Video? result = await _oEmbedConsumer.RequestAsync<Video>("https://vimeo.com/22439234");

The result object is are similar to described in the spec

Models: Base, Link, Photo, Rich, Video

If you dont know which response models supported by provider, then use dynamic overload.

// Deserialize response based on provider preferences
dynamic? item = await _oEmbedConsumer.RequestAsync(url);

if (item is not null)
{
  if (item is Video) 
  { 
    // work with video 
  }
  elseif (item is Photo) 
  { 
    // work with photo 
  }
  else { //do something }
}
Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on OEmbed:

Package Downloads
OEmbed.Extensions.Microsoft.DependencyInjection

OEmbed extensions for ASP.NET Core.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
4.0.1 1,202 5/21/2025
4.0.0 11,875 1/22/2024
3.0.0 59,405 6/7/2023
2.0.1 1,002 10/28/2022
2.0.0 14,923 5/18/2022
1.6.1 726 4/1/2022
1.6.0 718 3/24/2022
1.5.0 677 3/23/2022
1.4.0 821 3/23/2022
1.3.0 676 3/21/2022
1.2.0 725 3/19/2022
1.1.0 716 3/18/2022
1.0.1 750 3/17/2022
1.0.0 731 3/17/2022

https://github.com/hey-red/OEmbed/releases