Oembed Post

On April 8, 2025, we introduced a new oEmbed feature, Meta oEmbed Read to replace the existing oEmbed Read feature. The current oEmbed Read feature will be deprecated on October 1, 2025.

Apps created after April 8, 2025 that implement oEmbed will use the new Meta oEmbed Read feature.
Existing apps that already use the current oEmbed Read feature will be automatically updated to the new Meta oEmbed Read feature by October 1, 2025.

The following fields are no longer returned and will be fully deprecated on October 1, 2025:

author_name
author_url
thumbnail_height
thumbnail_url
thumbnail_width

Read the oEmbed Updates blog post from Meta to learn more.

Reading

OembedPost

Example

Graph API Explorer

GET /v23.0/oembed_post HTTP/1.1
Host: graph.facebook.com

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/oembed_post',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

/* make the API call */
FB.api(
    "/oembed_post",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/oembed_post",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/oembed_post"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

If you want to learn how to use the Graph API, read our Using Graph API guide.

Parameters

Parameter	Description
`maxwidth` int64	Maximum width of returned post.
`omitscript` boolean	Default value: `false` If set to true, the returned embed HTML code will not include any javascript.
`sdklocale` string	sdklocale
`url` URI	The post's URL. Required
`useiframe` boolean	Default value: `false` useiframe

Fields

Field	Description
`author_name` string	The name of the Facebook user that owns the post. Default
`author_url` string	A URL for the author/owner of the post. Default
`height` int32	The height in pixels required to display the HTML. Default
`html` string	The HTML used to display the post. Default
`provider_name` string	Name of the provider (Facebook). Default
`provider_url` string	URL of the provider (Facebook). Default
`type` string	The oEmbed resource type. See https://oembed.com/. Default
`version` string	Always 1.0. See https://oembed.com/ Default
`width` int32	The width in pixels required to display the HTML. Default

Error Codes

Error	Description
100	Invalid parameter
200	Permissions error
190	Invalid OAuth 2.0 Access Token

Creating

You can't perform this operation on this endpoint.

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.