WP_oEmbed::get_data( string $url, string|array $args = '' ): object|false

Takes a URL and attempts to return the oEmbed data.


Top ↑

See also

Top ↑


$url string Required
The URL to the content that should be attempted to be embedded.
$args string|array Optional
Additional arguments for retrieving embed HTML.
See wp_oembed_get() for accepted arguments.
More Arguments from wp_oembed_get( ... $args ) Additional arguments for retrieving embed HTML.
  • widthint|string
    Optional. The maxwidth value passed to the provider URL.
  • heightint|string
    Optional. The maxheight value passed to the provider URL.
  • discoverbool
    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: ''

Top ↑


object|false The result in the form of an object on success, false on failure.

Top ↑


File: wp-includes/class-wp-oembed.php. View all references

public function get_data( $url, $args = '' ) {
	$args = wp_parse_args( $args );

	$provider = $this->get_provider( $url, $args );

	if ( ! $provider ) {
		return false;

	$data = $this->fetch( $provider, $url, $args );

	if ( false === $data ) {
		return false;

	return $data;

Top ↑


Version Description
4.8.0 Introduced.

Top ↑

User Contributed Notes

You must log in before being able to contribute a note or feedback.