wp_remote_request ( $url, $args = array() )

  • (string) $url Site URL to retrieve.
  • (array) $args Optional. Request arguments. Default empty array.
  • WP_Http::request()
  • (WP_Error|array) The response or WP_Error on failure.
Defined at:


Retrieve the raw response from the HTTP request.

The array structure is a little complex:

$res = array(
    'headers'  => array(),
    'response' => array(
        'code'    => int,
        'message' => string

All of the headers in $res['headers'] are with the name as the key and the value as the value. So to get the User-Agent, you would do the following.

$user_agent = $res['headers']['user-agent'];

The body is the raw response content and can be retrieved from $res['body'].

This function is called first to make the request and there are other API functions to abstract out the above convoluted setup.

Request method defaults for helper functions: - Default 'GET' for wp_remote_get() - Default 'POST' for wp_remote_post() - Default 'HEAD' for wp_remote_head()

Related Functions

wp_safe_remote_request, wp_remote_get, wp_remote_post, wp_create_user_request, wp_is_xml_request

Top Google Results

User discussions

wpseek mobile