GET /batch/

Run several GET endpoints and return them as an array.

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)
false:
(default)
true:
Some environments (like in-browser JavaScript or Flash) block or divert responses with a non-200 HTTP status code. Setting this parameter will force the HTTP status code to always be 200. The JSON response is wrapped in an "envelope" containing the "real" HTTP status code and headers.
pretty (bool)
false:
(default)
true:
Output pretty JSON
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": "http:\/\/matt.blog",
        "jetpack": false,
        "subscribers_count": 235935,
        "lang": false,
        "icon": {
            "img": "https:\/\/secure.gravatar.com\/blavatar\/1dda380e30f5105e49d00ff16adc24a4",
            "ico": "https:\/\/secure.gravatar.com\/blavatar\/1dda380e30f5105e49d00ff16adc24a4"
        },
        "logo": {
            "id": 0,
            "sizes": [],
            "url": ""
        },
        "visible": null,
        "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": 2342,
        "posts": [
            {
                "ID": 7868,
                "site_ID": 4,
                "author": {
                    "ID": 5,
                    "login": "matt",
                    "email": false,
                    "name": "Matt",
                    "first_name": "Matt",
                    "last_name": "Mullenweg",
                    "nice_name": "matt",
                    "URL": "https:\/\/matt.blog\/",
                    "avatar_URL": "https:\/\/1.gravatar.com\/avatar\/767fc9c115a1b989744c755db47feb60?s=96&d=retro&r=G",
                    "profile_URL": "https:\/\/en.gravatar.com\/matt",
                    "ip_address": false,
                    "site_ID": 4
                },
                "date": "2017-10-12T00:09:03+00:00",
                "modified": "2017-10-12T00:09:03+00:00",
                "title": "Echeveria Pulidonis #L16photo",
                "URL": "http:\/\/matt.blog\/2017\/10\/12\/echeveria-pulidonis-l16photo\/",
                "short_URL": "http:\/\/wp.me\/p4-22U",
                "content": "<p><img data-attachment-id=\"7869\" data-permalink=\"http:\/\/matt.blog\/2017\/10\/12\/echeveria-pulidonis-l16photo\/l16_00006\/\" data-orig-file=\"https:\/\/matt.files.wordpress.com\/2017\/10\/l16_00006.jpg?w=6016&h=4512\" data-orig-size=\"6016,4512\" data-comments-opened=\"1\" data-image-meta=\"{&quot;aperture&quot;:&quot;15.13&quot;,&quot;credit&quot;:&quot;&quot;,&quot;camera&quot;:&quot;L16&quot;,&quot;caption&quot;:&quot;&quot;,&quot;created_timestamp&quot;:&quot;0&quot;,&quot;copyright&quot;:&quot;&quot;,&quot;focal_length&quot;:&quot;0&quot;,&quot;iso&quot;:&quot;0&quot;,&quot;shutter_speed&quot;:&quot;0.0075128674507141&quot;,&quot;title&quot;:&quot;&quot;,&quot;orientation&quot;:&quot;1&quot;}\" data-image-title=\"L16_00006\" data-image-description=\"\" data-medium-file=\"https:\/\/matt.files.wordpress.com\/2017\/10\/l16_00006.jpg?w=6016&h=4512?w=300\" data-large-file=\"https:\/\/matt.files.wordpress.com\/2017\/10\/l16_00006.jpg?w=6016&h=4512?w=1024\" class=\"alignnone size-full wp-image-7869\" src=\"https:\/\/matt.files.wordpress.com\/2017\/10\/l16_00006.jpg?w=6016&h=4512\" alt=\"L16_00006.jpg\" width=\"6016\" height=\"4512\" srcset=\"https:\/\/matt.files.wordpress.com\/2017\/10\/l16_00006.jpg 6016w, https:\/\/matt.files.wordpress.com\/2017\/10\/l16_00006.jpg?w=150&amp;h=113 150w, https:\/\/matt.files.wordpress.com\/2017\/10\/l16_00006.jpg?w=300&amp;h=225 300w, https:\/\/matt.files.wordpress.com\/2017\/10\/l16_00006.jpg?w=768&amp;h=576 768w, https:\/\/matt.files.wordpress.com\/2017\/10\/l16_00006.jpg?w=1024&amp;h=768 1024w\" sizes=\"(max-width: 6016px) 100vw, 6016px\" \/><\/p>\n<p>My first post from the new <a href=\"https:\/\/light.co\/\">L16 Light camera<\/a>.<\/p>\n",
                "excerpt": "<p>My first post from the new L16 Light camera.<\/p>\n",
                "slug": "echeveria-pulidonis-l16photo",
                "guid": "http:\/\/matt.blog\/?p=7868",
                "status": "publish",
                "sticky": false,
                "password": "",
                "parent": false,
                "type": "post",
                "comments_open": true,
                "pings_open": true,
                "likes_enabled": true,
                "sharing_enabled": true,
                "comment_count": 7,
                "like_count": 98,
                "i_like": false,
                "is_reblogged": false,
                "is_following": false,
                "global_ID": "418c46c0e799d6300acdada4c83779e4",
                "featured_image": "",
                "post_thumbnail": null,
                "format": "image",
                "geo": false,
                "menu_order": 0,
                "publicize_URLs": [],
                "tags": {
                    "L16photo": {
                        "ID": 592918407,
                        "name": "L16photo",
                        "slug": "l16photo",
                        "description": "",
                        "post_count": 1,
                        "meta": {
                            "links": {
                                "self": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/4\/tags\/slug:l16photo",
                                "help": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/4\/tags\/slug:l16photo\/help",
                                "site": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/4"
                            }
                        }
                    },
                    "photomattchallenge": {
                        "ID": 590219345,
                        "name": "photomattchallenge",
                        "slug": "photomattchallenge",
                        "description": "",
                        "post_count": 3,
                        "meta": {
                            "links": {
                                "self": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/4\/tags\/slug:photomattchallenge",
                                "help": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/4\/tags\/slug:photomattchallenge\/help",
                                "site": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/4"
                            }
                        }
                    }
                },
                "categories": {
                    "Moblog": {
                        "ID": 26114,
                        "name": "Moblog",
                        "slug": "moblog",
                        "description": "",
                        "post_count": 2289,
                        "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": {
                    "7869": {
                        "ID": 7869,
                        "URL": "https:\/\/matt.files.wordpress.com\/2017\/10\/l16_00006.jpg",
                        "guid": "http:\/\/matt.files.wordpress.com\/2017\/10\/l16_00006.jpg",
                        "mime_type": "image\/jpeg",
                        "width": 6016,
                        "height": 4512
                    }
                },
                "metadata": [
                    {
                        "id": "67673",
                        "key": "_wpas_done_4543371",
                        "value": "1"
                    },
                    {
                        "id": "67680",
                        "key": "_wpas_done_590",
                        "value": "1"
                    },
                    {
                        "id": "67670",
                        "key": "_wpas_done_591",
                        "value": "1"
                    },
                    {
                        "id": "67682",
                        "key": "_wpas_done_592",
                        "value": "1"
                    },
                    {
                        "id": "67674",
                        "key": "_wpas_path_publicize_failure",
                        "value": {
                            "errors": {
                                "keyring-request-error": [
                                    {
                                        "errors": {
                                            "http_request_failed": [
                                                "cURL error 28: Operation timed out after 5000 milliseconds with 0 bytes received"
                                            ]
                                        },
                                        "error_data": []
                                    }
                                ]
                            },
                            "error_data": []
                        }
                    },
                    {
                        "id": "67676",
                        "key": "_wpas_tumblr_publicize_failure",
                        "value": {
                            "request_url": "http:\/\/api.tumblr.com\/v2\/blog\/photomatt.tumblr.com\/post",
                            "response": {
                                "errors": {
                                    "keyring-request-error": [
                                        {
                                            "headers": {},
                                            "body": "{\"meta\":{\"status\":400,\"msg\":\"Bad Request\"},\"response\":{\"errors\":[\"Error uploading photo.\"]}}",
                                            "response": {
                                                "code": 400,
                                                "message": "Bad Request"
                                            },
                                            "cookies": [
                                                {
                                                    "name": "tmgioct",
                                                    "value": "59deb2b13972220304540380",
                                                    "expires": 1539302961,
                                                    "path": "\/",
                                                    "domain": "tumblr.com"
                                                }
                                            ],
                                            "filename": null,
                                            "http_response": {
                                                "data": null,
                                                "headers": null,
                                                "status": null
                                            }
                                        }
                                    ]
                                },
                                "error_data": []
                            }
                        }
                    }
                ],
                "meta": {
                    "links": {
                        "self": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/4\/posts\/7868",
                        "help": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/4\/posts\/7868\/help",
                        "site": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/4",
                        "replies": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/4\/posts\/7868\/replies\/",
                        "likes": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/4\/posts\/7868\/likes\/"
                    }
                },
                "current_user_can": {
                    "publish_post": false,
                    "delete_post": false,
                    "edit_post": false
                },
                "capabilities": {
                    "publish_post": false,
                    "delete_post": false,
                    "edit_post": false
                }
            }
        ]
    }
}