Developer Resources

Resource Information


Method	GET
URL	https://public-api.wordpress.com/rest/v1.1/meta/external-services/
Requires authentication?	No

Query Parameters

Parameter	Type	Description
context	(string)	display: (default) Formats the output as HTML for display. Shortcodes are parsed, paragraph tags are added, etc.. edit: Formats the output for editing. Shortcodes are left unparsed, significant whitespace is kept, etc..
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.
type	(string)	Optional. Only return services for the given type. Currently the only supported types are `publicize` or `other`.

Response Parameters

Parameter	Type	Description
services	(array)	List of supported services. See /meta/external-services/%s for service descriptions.

Resource Errors

These are the possible errors returned by this endpoint.

HTTP Code	Error Identifier	Error Message
400	invalid_input	The type provided does not exist

Example

curl 'https://public-api.wordpress.com/rest/v1.1/meta/external-services/'

<?php
$options  = array (
  'http' => 
  array (
    'ignore_errors' => true,
  ),
);

$context  = stream_context_create( $options );
$response = file_get_contents(
	'https://public-api.wordpress.com/rest/v1.1/meta/external-services/',
	false,
	$context
);
$response = json_decode( $response );
?>

Response

{
    "services": {
        "facebook": {
            "ID": "facebook",
            "label": "Facebook",
            "type": "publicize",
            "description": "Publish your posts to your Facebook timeline or page.",
            "genericon": {
                "class": "facebook-alt",
                "unicode": "\\f203"
            },
            "icon": "http:\/\/i.wordpress.com\/wp-content\/admin-plugins\/publicize\/assets\/publicize-fb-2x.png",
            "connect_URL": "https:\/\/public-api.wordpress.com\/connect\/?action=request&kr_nonce=70c3c66463&nonce=e978dfe9aa&for=connect&service=facebook&kr_blog_nonce=314cc2bafc&magic=keyring&blog=2916284",
            "multiple_external_user_ID_support": true,
            "external_users_only": true,
            "jetpack_support": true,
            "jetpack_module_required": "publicize"
        },
        "twitter": {
            "ID": "twitter",
            "label": "Twitter",
            "type": "publicize",
            "description": "Publish your posts to your Twitter account.",
            "genericon": {
                "class": "twitter",
                "unicode": "\\f202"
            },
            "icon": "http:\/\/i.wordpress.com\/wp-content\/admin-plugins\/publicize\/assets\/publicize-twitter-2x.png",
            "connect_URL": "https:\/\/public-api.wordpress.com\/connect\/?action=request&kr_nonce=70c3c66463&nonce=538e7737df&for=connect&service=twitter&kr_blog_nonce=314cc2bafc&magic=keyring&blog=2916284",
            "multiple_external_user_ID_support": false,
            "external_users_only": false,
            "jetpack_support": true,
            "jetpack_module_required": "publicize"
        },
        "linkedin": {
            "ID": "linkedin",
            "label": "LinkedIn",
            "type": "publicize",
            "description": "Publish your posts to your LinkedIn profile.",
            "genericon": {
                "class": "linkedin",
                "unicode": "\\f207"
            },
            "icon": "http:\/\/i.wordpress.com\/wp-content\/admin-plugins\/publicize\/assets\/publicize-linkedin-2x.png",
            "connect_URL": "https:\/\/public-api.wordpress.com\/connect\/?action=request&kr_nonce=70c3c66463&nonce=72f934e0b5&for=connect&service=linkedin&kr_blog_nonce=314cc2bafc&magic=keyring&blog=2916284",
            "multiple_external_user_ID_support": false,
            "external_users_only": false,
            "jetpack_support": true,
            "jetpack_module_required": "publicize"
        },
        "tumblr": {
            "ID": "tumblr",
            "label": "Tumblr",
            "type": "publicize",
            "description": "Publish your posts to your Tumblr blog.",
            "genericon": {
                "class": "tumblr",
                "unicode": "\\f214"
            },
            "icon": "http:\/\/i.wordpress.com\/wp-content\/admin-plugins\/publicize\/assets\/publicize-tumblr-2x.png",
            "multiple_external_user_ID_support": true,
            "external_users_only": false,
            "connect_URL": "https:\/\/public-api.wordpress.com\/connect\/?action=request&kr_nonce=70c3c66463&nonce=78b628e1e1&for=connect&service=tumblr&kr_blog_nonce=314cc2bafc&magic=keyring&blog=2916284",
            "jetpack_support": true,
            "jetpack_module_required": "publicize"
        },
        "eventbrite": {
            "ID": "eventbrite",
            "label": "Eventbrite",
            "type": "other",
            "description": "Connect to Eventbrite",
            "genericon": {
                "class": "eventbrite",
                "unicode": "\\f8a6"
            },
            "icon": "http:\/\/i.wordpress.com\/wp-content\/lib\/eventbrite-api\/eventbrite-2x.png",
            "connect_URL": "https:\/\/public-api.wordpress.com\/connect\/?action=request&kr_nonce=70c3c66463&nonce=8ed5b791ec&for=connect&service=eventbrite&kr_blog_nonce=314cc2bafc&magic=keyring&blog=2916284",
            "multiple_external_user_ID_support": false,
            "external_users_only": false,
            "jetpack_support": false,
            "warnings": [
                {
                    "level": "error",
                    "message": "Eventbrite has shut down a service on which WordPress.com relies for data. No new connections can be made as of Dec 12, 2019, and all existing connections will shut down on February 20, 2020."
                }
            ]
        },
        "google_photos": {
            "ID": "google_photos",
            "label": "Google Photos",
            "type": "other",
            "description": "Access photos in your Google Account for use in posts and pages",
            "genericon": {
                "class": "googleplus-alt",
                "unicode": "\\f218"
            },
            "icon": "http:\/\/i.wordpress.com\/wp-content\/lib\/external-media-service\/icon\/google-photos-2x.png",
            "connect_URL": "https:\/\/public-api.wordpress.com\/connect\/?action=request&kr_nonce=70c3c66463&nonce=b39bd765cd&for=connect&service=google_photos&kr_blog_nonce=314cc2bafc&magic=keyring&blog=2916284",
            "multiple_external_user_ID_support": false,
            "external_users_only": false,
            "jetpack_support": true
        },
        "google_my_business": {
            "ID": "google_my_business",
            "label": "Google My Business",
            "type": "other",
            "description": "Connect to your Google My Business account",
            "genericon": {
                "class": "googleplus-alt",
                "unicode": "\\f218"
            },
            "icon": "http:\/\/i.wordpress.com\/wp-content\/lib\/google\/icon\/google-my-business-2x.png",
            "connect_URL": "https:\/\/public-api.wordpress.com\/connect\/?action=request&kr_nonce=70c3c66463&nonce=6b3a59e916&for=connect&service=google_my_business&kr_blog_nonce=314cc2bafc&magic=keyring&blog=2916284",
            "multiple_external_user_ID_support": true,
            "external_users_only": true,
            "jetpack_support": true
        },
        "google_site_verification": {
            "ID": "google_site_verification",
            "label": "Google Site Verification",
            "type": "other",
            "description": "Connect to your Google account to verify a site",
            "genericon": {
                "class": "googleplus-alt",
                "unicode": "\\f218"
            },
            "icon": "http:\/\/i.wordpress.com\/wp-content\/admin-plugins\/publicize\/assets\/publicize-google-2x.png",
            "connect_URL": "https:\/\/public-api.wordpress.com\/connect\/?action=request&kr_nonce=70c3c66463&nonce=8a38c6f38c&for=connect&service=google_site_verification&kr_blog_nonce=314cc2bafc&magic=keyring&blog=2916284",
            "multiple_external_user_ID_support": false,
            "external_users_only": false,
            "jetpack_support": true
        },
        "google-drive": {
            "ID": "google-drive",
            "label": "Google Drive",
            "type": "other",
            "description": "Connect to your Google Drive",
            "genericon": {
                "class": "mail",
                "unicode": "\\f218"
            },
            "icon": "",
            "connect_URL": "https:\/\/public-api.wordpress.com\/connect\/?action=request&kr_nonce=70c3c66463&nonce=33ba2ab650&for=connect&service=google-drive&kr_blog_nonce=314cc2bafc&magic=keyring&blog=2916284",
            "multiple_external_user_ID_support": false,
            "external_users_only": false,
            "jetpack_support": true
        },
        "mailchimp": {
            "ID": "mailchimp",
            "label": "Mailchimp",
            "type": "other",
            "description": "Connect to your Mailchimp list",
            "genericon": {
                "class": "mail",
                "unicode": "\\f218"
            },
            "icon": "http:\/\/i.wordpress.com\/wp-content\/lib\/google\/icon\/google-my-business-2x.png",
            "connect_URL": "https:\/\/public-api.wordpress.com\/connect\/?action=request&kr_nonce=70c3c66463&nonce=5b80594b29&for=connect&service=mailchimp&kr_blog_nonce=314cc2bafc&magic=keyring&blog=2916284",
            "multiple_external_user_ID_support": false,
            "external_users_only": true,
            "jetpack_support": true
        },
        "instagram-basic-display": {
            "ID": "instagram-basic-display",
            "label": "Instagram",
            "type": "other",
            "description": "Connect to your Instagram account",
            "genericon": {
                "class": "image",
                "unicode": "\\f218"
            },
            "icon": "",
            "connect_URL": "https:\/\/public-api.wordpress.com\/connect\/?action=request&kr_nonce=70c3c66463&nonce=7c9c59173b&for=instagram-widget&service=instagram-basic-display&kr_blog_nonce=314cc2bafc&magic=keyring&blog=2916284",
            "multiple_external_user_ID_support": false,
            "external_users_only": false,
            "jetpack_support": true
        }
    }
}