wp_oembed_get() – Function | Developer.WordPress.org

Attempts to fetch the embed HTML for a provided URL using oEmbed.

Description

$urlstringrequired

The URL that should be embedded.

$argsarray|stringoptional

Additional arguments for retrieving embed HTML.

width int|string
Optional. The maxwidth value passed to the provider URL.
height int|string
Optional. The maxheight value passed to the provider URL.
discover bool
Optional. Determines whether to attempt to discover link tags at the given URL for an oEmbed provider when the provider URL is not found in the built-in providers list. Default true.

Default:''

string|false The embed HTML on success, false on failure.

function wp_oembed_get( $url, $args = '' ) {
	$oembed = _wp_oembed_get_object();
	return $oembed->get_html( $url, $args );
}

Uses	Description
_wp_oembed_get_object()`wp-includes/embed.php`	Returns the initialized WP_oEmbed object.

Used by	Description
WP_Widget_Media_Video::render_media()`wp-includes/widgets/class-wp-widget-media-video.php`	Render the media on the frontend.
WP_Embed::shortcode()`wp-includes/class-wp-embed.php`	The do_shortcode() callback function.

Version	Description
2.9.0	Introduced.