Resource Information
| Method | GET |
|---|---|
| URL | https://public-api.wordpress.com/rest/v1.3/batch/ |
| Requires authentication? | No |
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| 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. |
| urls | (array) | Array of endpoints to call |
Resource Errors
These are the possible errors returned by this endpoint.
| HTTP Code | Error Identifier | Error Message |
|---|---|---|
| 400 | invalid_input | Invalid request input |
Example
curl 'https://public-api.wordpress.com/rest/v1/batch/?urls\[\]=/sites/4/&urls\[\]=/sites/4/posts?number=1'
<?php
$options = array (
'http' =>
array (
'ignore_errors' => true,
),
);
$context = stream_context_create( $options );
$response = file_get_contents(
'https://public-api.wordpress.com/rest/v1/batch/?urls[]=/sites/4/&urls[]=/sites/4/posts?number=1',
false,
$context
);
$response = json_decode( $response );
?>
Response
{
"\/sites\/4\/": {
"ID": 4,
"name": "Matt on Not-WordPress",
"description": "Stuff and things.",
"URL": "https:\/\/matt.wordpress.com",
"jetpack": false,
"subscribers_count": 229955,
"icon": {
"img": "https:\/\/secure.gravatar.com\/blavatar\/1dda380e30f5105e49d00ff16adc24a4",
"ico": "https:\/\/secure.gravatar.com\/blavatar\/cee3cad823afdeb7a7fefc50d7a264b9"
},
"logo": {
"id": 0,
"sizes": [],
"url": ""
},
"is_private": false,
"is_following": false,
"meta": {
"links": {
"self": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/4",
"help": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/4\/help",
"posts": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/4\/posts\/",
"comments": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/4\/comments\/",
"xmlrpc": "https:\/\/matt.wordpress.com\/xmlrpc.php"
}
}
},
"\/sites\/4\/posts?number=1": {
"found": 2283,
"posts": [
{
"ID": 7568,
"site_ID": 4,
"author": {
"ID": 5,
"login": "matt",
"email": false,
"name": "Matt",
"nice_name": "matt",
"URL": "http:\/\/matt.wordpress.com",
"avatar_URL": "https:\/\/1.gravatar.com\/avatar\/767fc9c115a1b989744c755db47feb60?s=96&d=retro&r=G",
"profile_URL": "http:\/\/en.gravatar.com\/matt",
"site_ID": 4
},
"date": "2015-04-18T20:39:16+00:00",
"modified": "2015-04-18T20:39:16+00:00",
"title": "Post No Bill?",
"URL": "https:\/\/matt.wordpress.com\/2015\/04\/18\/post-no-bill\/",
"short_URL": "http:\/\/wp.me\/p4-1Y4",
"content": "<p><a href=\"http:\/\/matt.files.wordpress.com\/2015\/04\/fullsizerender2.jpg\"><img src=\"https:\/\/matt.files.wordpress.com\/2015\/04\/fullsizerender2.jpg?w=768&h=576\" alt=\"\" width=\"768\" height=\"576\" class=\"alignnone size-full wp-image-7569\" \/><\/a><\/p>\n",
"excerpt": "",
"slug": "post-no-bill",
"guid": "https:\/\/matt.wordpress.com\/?p=7568",
"status": "publish",
"sticky": false,
"password": "",
"parent": false,
"type": "post",
"comments_open": true,
"pings_open": true,
"likes_enabled": true,
"sharing_enabled": true,
"comment_count": 0,
"like_count": 117,
"i_like": 0,
"is_reblogged": 0,
"is_following": 0,
"global_ID": "1ebb1ee975df30ae268633a2ea687053",
"featured_image": "",
"post_thumbnail": null,
"format": "image",
"geo": false,
"menu_order": 0,
"publicize_URLs": [],
"tags": {},
"categories": {
"Moblog": {
"ID": 26114,
"name": "Moblog",
"slug": "moblog",
"description": "",
"post_count": 2230,
"parent": 0,
"meta": {
"links": {
"self": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/4\/categories\/slug:moblog",
"help": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/4\/categories\/slug:moblog\/help",
"site": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/4"
}
}
}
},
"attachments": {
"7569": {
"ID": 7569,
"URL": "https:\/\/matt.files.wordpress.com\/2015\/04\/fullsizerender2.jpg",
"guid": "http:\/\/matt.files.wordpress.com\/2015\/04\/fullsizerender2.jpg",
"mime_type": "image\/jpeg",
"width": 3264,
"height": 2448
}
},
"metadata": [
{
"id": "65331",
"key": "geo_accuracy",
"value": "40"
},
{
"id": "65329",
"key": "geo_latitude",
"value": "40.720178"
},
{
"id": "65330",
"key": "geo_longitude",
"value": "-74.000061"
},
{
"id": "65346",
"key": "_wpas_done_2191330",
"value": "1"
},
{
"id": "65339",
"key": "_wpas_done_4543371",
"value": "1"
},
{
"id": "65344",
"key": "_wpas_done_590",
"value": "1"
},
{
"id": "65335",
"key": "_wpas_done_591",
"value": "1"
},
{
"id": "65342",
"key": "_wpas_done_592",
"value": "1"
},
{
"id": "65347",
"key": "_wpas_path_publicize_failure",
"value": {
"errors": {
"keyring-request-error": [
{
"headers": {
"server": "nginx",
"date": "Sat, 18 Apr 2015 20:40:29 GMT",
"content-type": "application\/json",
"content-length": "134",
"connection": "close"
},
"body": "{\"reason\": \"Accepted for processing\", \"code\": 202, \"type\": \"ACCEPTED\", \"moment\": {\"type\": \"photo\", \"id\": \"5532c13d27381e1e7c03a7c4\"}}\n",
"response": {
"code": 202,
"message": "ACCEPTED"
},
"cookies": [],
"filename": null
}
]
},
"error_data": []
}
}
],
"meta": {
"links": {
"self": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/4\/posts\/7568",
"help": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/4\/posts\/7568\/help",
"site": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/4",
"replies": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/4\/posts\/7568\/replies\/",
"likes": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/4\/posts\/7568\/likes\/"
}
},
"current_user_can": {
"publish_post": false,
"delete_post": false,
"edit_post": false
},
"capabilities": {
"publish_post": false,
"delete_post": false,
"edit_post": false
}
}
]
}
}
