This endpoint is deprecated in favor of version 1.1
Resource Information
Method | GET |
---|---|
URL | https://public-api.wordpress.com/rest/v1/sites/$site/media/ |
Requires authentication? | Yes |
Method Parameters
Parameter | Type | Description |
---|---|---|
$site | (int|string) | Site ID or domain |
Query Parameters
Parameter | Type | Description |
---|---|---|
context | (string) |
|
http_envelope | (bool) |
|
pretty | (bool) |
|
meta | (string) | Optional. Loads data from the endpoints found in the 'meta' part of the response. Comma-separated list. Example: meta=site,likes |
fields | (string) | Optional. Returns specified fields only. Comma-separated list. Example: fields=ID,title |
callback | (string) | An optional JSONP callback function. |
number | (int) | The number of media items to return. Limit: 100. Default: 20. |
offset | (int) | 0-indexed offset. |
parent_id | (int) | Default is showing all items. The post where the media item is attached. 0 shows unattached media items. |
mime_type | (string) | Default is empty. Filter by mime type (e.g., 'image/jpeg', 'application/pdf'). Partial searches also work (e.g. passing 'image' will search for all image files). |
Response Parameters
Parameter | Type | Description |
---|---|---|
media | (array) | Array of media |
found | (int) | The number of total results found |
Resource Errors
This endpoint does not return any errors.
Example
curl \ -H 'authorization: Bearer YOUR_API_TOKEN' \ 'https://public-api.wordpress.com/rest/v1/sites/82974409/media/?number=2'
<?php $options = array ( 'http' => array ( 'ignore_errors' => true, 'header' => array ( 0 => 'authorization: Bearer YOUR_API_TOKEN', ), ), ); $context = stream_context_create( $options ); $response = file_get_contents( 'https://public-api.wordpress.com/rest/v1/sites/82974409/media/?number=2', false, $context ); $response = json_decode( $response ); ?>