oEmbed consumer library for Elixir applications.
oEmbed is a format for allowing an embedded representation of a URL on third party sites. The simple API allows a website to display embedded content (such as photos or videos) when a user posts a link to that resource, without having to parse the resource directly.
-- See oembed.com for more info about the protocol.
This library supports any discoverable oEmbed endpoint and some other services via custom adapters. Among them:
- YouTube
- Vimeo
Add oembed to your list of dependencies in mix.exs:
def deps do
[{:oembed, "~> 0.4.1"}]
end{:ok, result} = OEmbed.for("https://www.youtube.com/watch?v=dQw4w9WgXcQ")You can implement modules that support provider behaviour and add them to the provider list from your app config
config :oembed, :providers, [MyApp.OEmbed.SomeProvider, MyApp.OEmbed.SomeOtherProvider]You can implement extra request options to be fed to HTTPoison, by adding them in the config. This is useful when you would like to do all request via a Proxy for example.
config :oembed, :request_opts, [proxy: "http://my-very-own.webproxy.com:1234", proxy_auth: {"user_name", "password"}]