WP_oEmbed::get_data() – Method | Developer.WordPress.org

Takes a URL and attempts to return the oEmbed data.

Description

Parameters

$urlstringrequired

The URL to the content that should be attempted to be embedded.

$argsstring|arrayoptional

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.

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:''

Return

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

Source

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;
}

View all references View on Trac View on GitHub

Uses	Description
WP_oEmbed::get_provider()`wp-includes/class-wp-oembed.php`	Takes a URL and returns the corresponding oEmbed provider’s URL, if there is one.
WP_oEmbed::fetch()`wp-includes/class-wp-oembed.php`	Connects to an oEmbed provider and returns the result.
wp_parse_args()`wp-includes/functions.php`	Merges user defined arguments into defaults array.

Show 1 more Show less

Used by	Description
WP_oEmbed::get_html()`wp-includes/class-wp-oembed.php`	The do-it-all function that takes a URL and attempts to return the HTML.

Changelog

Version	Description
4.8.0	Introduced.

User Contributed Notes

Skip to note 2 content

drzraf 8 months ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

This function is notoriously used by the Youtube Gutenberg block to retrieve video markup (among other)
It’s subject to any Google/Vimeo/… oEmbed provider blacklisting strategy. As an example, we found that Youtube would ban any WordPress instance hosted on OVH/US-cloud IP range from retrieving the markup (= strongly limiting oEmbed, thus WP hosting on a (competing) hosting provider)

Log in to add feedback

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

In this article