Link

A link shared on a user's wall. The User, Application, and Page objects have a links connection.

To read a Link, you need:

Example

A link shared by Arjun Banker:

Name	Description	Permissions	Returns
`id`	The link ID	generic `access_token` or `read_stream`	`string`
`from`	The user that created the link	generic `access_token` or `read_stream`	Object containing the `id` and `name` field
`link`	The URL that was shared	generic `access_token` or `read_stream`	`string` containing a valid URL
`name`	The name of the link	generic `access_token` or `read_stream`	`string`
`comments`	All of the comments on this link	`read_stream`	Array of objects containing `id`, `from`, `message` and `created_time` fields
`description`	A description of the link (appears beneath the link caption)	generic `access_token` or `read_stream`	`string`
`icon`	A URL to the link icon that Facebook displays in the news feed	generic `access_token` or `read_stream`	`string` containing a valid URL
`picture`	A URL to the thumbnail image used in the link post	generic `access_token` or `read_stream`	`string` containing a valid URL
`message`	The optional message from the user about this link	generic `access_token` or `read_stream`	`string`
`created_time`	The time the message was published	generic `access_token` or `read_stream`	`string` containing ISO-8601 date-time
`type`	The type of this object; always returns `link`	generic `access_token` or `read_stream`	`string`

Name	Description	Permissions	Returns
comments	All of the comments on this link.	`read_stream`	`array` of objects containing `id`, `from`, `message` and `created_time` fields.
likes	Users who like this link.	`read_stream`	`array` of objects containing the `id` and `name` fields.

You can comment on a Link by issuing an HTTP POST request to /LINK_ID/comments with the publish_stream permission and following parameters.

Parameter	Description	Type	Required
`message`	Comment text	`string`	yes

If the create is successful, you get the following return.

Name	Description	Type
`id`	The new comment ID	`string`

Updated over a year ago