/?id={url}
Represents a URL shared in a Post or in a Comment on a Post.
Refer to our News Tab Indexing API documentation for additional information.
Get information about a URL that was shared in a Post or a Comment on a Post.
Type | Description |
---|---|
Access Tokens | Any access token can be used to make this request. |
Features | Not applicable. |
Page Tasks | Not applicable. |
Permissions | Not applicable. |
Include the following query string parameters to augment the request.
Parameter | Description |
---|---|
Required string | An access token. |
string | A comma-separated list of fields you want to request. |
string | The url to be shared. |
string | A comma-separated list of scopes. |
Property Name | Description | Type |
---|---|---|
app_links | AppLinks data associated with this URL, if available. | AppLinks |
| The URL itself. |
|
| Counts of different ways people interacted with the URL Note that engagement values are intentionally not precise, but you can be confident they accurately reflect user engagement with a URL. |
|
| The Open Graph object that is canonically associated with this URL. |
|
To get information about a URL published in a Post or Comment, send a GET
request to https://graph.facebook.com
with the id
parameter set to the URL, any fields about the URL, and an access token requested from the User or Page who published the Post or Comment.
The follow example shows the engagement for the URL, https://www.facebook.com, that was shared by the User represented by the User access token.
Formatted for readability.curl -i -X GET \ "https://graph.facebook.com/{latest-graph-api-version}/ ?id=https://www.facebook.com &fields=engagement &access_token={user-access-token}"
On success your app receives the following engagement counts for the URL that was shared:
{ "engagement": { "reaction_count": 514919172, "comment_count": 68687082, "share_count": 975739682, "comment_plugin_count": 1641 }, "id": "https://www.facebook.com" }
You can't perform this operation on this endpoint.
Update a URL.
Type | Description |
---|---|
Access Tokens | Any access token can be used to make this request. |
Features | Not applicable. |
Page Tasks | Not applicable. |
Permissions | Not applicable. |
To update information about a URL published in a Post or Comment, send a POST
request to https://graph.facebook.com
with the id
parameter set to the URL, the scrape
parameter set to true
, any fields
about the URL, and an access token requested from the User or Page who published the Post or Comment.
The follow example updates the URL, https://www.facebook.com/my-update, that was shared by the User represented by the User access token.
Formatted for readability.curl -i -X POST \ "https://graph.facebook.com/{latest-graph-api-version}/ ?id=https://www.facebook.com/my-update &scrape=true &access_token={user-access-token}"
On success your app receives the following engagement counts for the URL that was shared:
{ "success": true }
Include the following query string parameters to augment the request.
Parameter | Description |
---|---|
Required string | An access token. |
string | A comma-separated list of fields you want to request. |
Required string | The url to be updated. The url must be encoded so that it does not interfere with the |
Required boolean | Value must be |
POST /{version}/?id={url}&scrape=true Host: graph.facebook.com
{ "success": true }
You can't perform this operation on this endpoint.