apply_filters( 'pre_oembed_result', null|string $result, string $url, array $args )

Filters the oEmbed result before any HTTP requests are made.

Description

This allows one to short-circuit the default logic, perhaps by replacing it with a routine that is more optimal for your setup.

Passing a non-null value to the filter will effectively short-circuit retrieval, returning the passed value instead.

$result: The UNSANITIZED (and potentially unsafe) HTML that should be used to embed. Default null.
$url: The URL to the content that should be attempted to be embedded.
$args: Arguments, usually passed from a shortcode. Default empty.

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

Changelog
Version	Description
WP-4.5.3	Introduced.