GET /recommend
Retrieve recommended URL infos.
Example
https://api.viadeo.com/recommend?url=http://dev.viadeo.com&language=fr&limit=10&access_token=...
Query parameters
| Parameter name | Description | Type | Default value |
| language= | Language in which the profile will be displayed. Default value is the navigation language of the user on the website. | ISO-639 | |
| limit= | Number of items per page. | INTEGER (min: 0 max: 100) | 10 |
| only_contacts= | Only consider sharing users in the user contacts list. | STRING | FALSE |
| page= | Page number to retrieve. | INTEGER (min: 1 max: 50) | 1 |
| start= | Offset of the first item; the index of the first item retrieved. The first item in the response will therefore be = start + page * limit. | INTEGER (min: 1 max: 2500) | 1 |
| summary= | Do not show users list, only print head information about the link. | STRING | FALSE |
| url= | The URl to share (url-encoded). | URL | |
| user_detail= | Retrieve more information about a member's profile (location, headline, ...). Refer to our advanced API usesection for more information. | NONE | PARTIAL | FULL | NONE |
| user_pending_request= | Retrieve the id with the related user if there is any pending request. DEPRECATED, removed 2013-08-31. Reason: More ...complete information available by using /user/pending_requests connection - returns pending connection requests between you and given user. Replaced by: pending_requests connection. Deprecated since: 2013-01-31. | BOOLEAN | FALSE |
| user_watermark= | Provide pictures with a watermark. | BOOLEAN | TRUE |
Response [JSON] [XML]
| Field name | Description | Type |
| count | Number of elements in the list. | LONG |
| count_string | Number of elements in the list (as string). | STRING |
| data | List's items. | STRUCT LIST |
| domain | Domain of the shared url. Ex: www.lemonde.fr. | STRING |
| id | Graph resource's ID. | STRING |
| keywords | Shared url's ketwords. | STRING |
| link | Link to the current Graph resource on Viadeo website. | STRING |
| name | Graph resource's name. | STRING |
| overview | Shared url's overview. | STRING |
| paging | Paging data. | STRUCT |
| shared | True is currently logged in member has already shared this url. | BOOLEAN |
| sharing_message | Shared url's message. | STRING |
| site_name | Pretty name of the shared url's source Ex: Le Monde.fr. This is only set when pretty name is known ; use domain otherwise. | STRING |
| title | Shared url's title. | STRING |
| type | Graph resource's type. | STRING |
| updated_time | Graph resource's Last update date. | ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ] |
| url_picture | Shared url's picture url. | STRING |
POST /recommend
Premium resource
Allows user to recommend a new URL.
Example
curl --data-urlencode -X POST -d 'title=XxXxX&url=http://dev.viadeo.com&keywords=network,pro' https://api.viadeo.com/recommend?access_token=...
Query parameters
| Parameter name | Description | Type | Default value |
| keywords= | A list of comma-separated keywords for this URL. | STRING | |
| language= | Language in which the profile will be displayed. Default value is the navigation language of the user on the website. | ISO-639 | |
| message= | The message used with the URL share. | STRING | |
| overview= | An overview description for the URL. | STRING | |
| site_name= | Name the link provider website. | STRING | |
| title= | A title for the link. | STRING | |
| url= | Application url. | URL | |
| url_picture= | URL of a picture for this URL. | URL |
Response
| Field name | Description | Type |
| created | Always true if resource is created. | TRUE |
| created_graph_id | Created graph id. | STRING |
List of connections
| Connection path | Description |