Graph API Resource | Viadeo API

GET /<user_id>/home_newsfeed
List of connections

GET /<user_id>/home_newsfeed

Authenticated resource

Retrieve a member’s newsfeed i.e. a list of updates from a member’s professional contacts.

Example

https://api.viadeo.com/<user_id>/home_newsfeed?add_company_news=false&category=XxXxX&language=fr&access_token=...

Query parameters

Parameter name	Description	Type	Default value
add_company_news=	Add news from the followed companies.	BOOLEAN	FALSE
category=	Allows you to filter news with category IDs. IDs can be retrieved calling /newscategory/list.	LIST
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
page=	Page number to retrieve.	INTEGER (min: 1 max: 50)	1
since=	Filter items published since the specified date.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
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
until=	Filter items published until the specified date.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
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
category	Detail about the category of the news.	STRUCT
id	Graph resource's ID.	STRING
link	Link to the current Graph resource on Viadeo website.	STRING
name	Graph resource's name.	STRING
type	Graph resource's type.	STRING
updated_time	Graph resource's Last update date.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
comment_count	Total count of the comments made on this news.	INTEGER
company	The company which is related to this news – it’s type depends on news category. See complete list of news categories and refer to documentation of specific resources for more details.	STRUCT
banner	Banner of this company's profile.	STRING
blog_url	Blog url of this company's profile.	STRING
creation_date	Creation date of the company.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
description	Description of the member's current company.	STRING
employee_count	Number of employees of this company's profile.	INTEGER
fax	Company fax.	STRING
follower_count	Number of followers of this company's profile.	INTEGER
id	Graph resource's ID.	STRING
index_score	Index score of this company's profile.	DOUBLE
industry	Industry of the member's current company.	STRING
ipo_stock_symbol	IPO stock symbol of this company's profile.	STRING
is_followed	Indicate if this company is followed by me.	BOOLEAN
is_in_my_direct_network	Flag if one of my direct contacts is working in this company.	BOOLEAN
is_in_my_indirect_network	Flag if one of my indirect contacts is working in this company.	BOOLEAN
job_offer_count	Number of job offers provided by this company.	INTEGER
language	Language of this company's profile.	ISO-639
link	Link to the current Graph resource on Viadeo website.	STRING
location	Company's location.	STRUCT
address	Location's address.	STRING
address_2	Location's address.	STRING
area	Location's area. DEPRECATED, removed 2013-11-21. Replaced by: ...county field. Deprecated since: 2012-11-21.	STRING
city	Location's city.	STRING
country	Location's country.	STRING
country_code	Location's country code.	STRING
county	Location's county.	STRUCT
id	Entity's identifier.	STRING
name	Entity's name.	STRING
type	Entity's type.	STRING
description	Location's description.	STRING
latitude	Location's latitude.	STRING
longitude	Location's longitude.	STRING
timezone	Location's timezone.	STRING
zipcode	Location's zipcode.	STRING
logo	Logo URL of this company's profile.	STRING
name	Graph resource's name.	STRING
overview	Company's profile overview.	STRING
phone	Company phone.	STRING
products	Products of the member's current company.	STRING
short_url	Short url of this company's profile.	STRING
size	Size of the member's current company.	STRING
twitter_account	Company's Twitter account name.	STRING
type	Graph resource's type.	STRING
updated_time	Graph resource's Last update date.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
website_url	Web site url of this company's profile.	STRING
welcome_message	Welcome message from the company.	STRING
creation_date	The creation date of the news.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
description	The description of the shared article.	STRING
from	Member who created the news. By using the ?user_detail= query parameter here, you will be able to retrieve more information on the user. Refer to the advanced API usesection of the documentation.	STRUCT
birth_year	Year of birth of the member.	INTEGER
birthdate	Full date of birth of the member.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
contact_count	Member's number of contacts.	INTEGER
distance	Distance between the authenticated member and the viewed profile.	INTEGER
first_name	Member's first name.	STRING
gender	Gender of the member.	M\|F
has_picture	Indicates if the user has set a profile picture.	BOOLEAN
headline	Member's profile headline.	STRING
id	Graph resource's ID.	STRING
interests	List of the interests / hobbies of a member.	STRING
introduction	Member's profile introduction.	STRING
is_premium	Premium state of the member.	BOOLEAN
language	Language of this member's profile.	ISO-639
last_name	Member's last name.	STRING
link	Link to the current Graph resource on Viadeo website.	STRING
location	Member's location.	STRUCT
address	Location's address.	STRING
address_2	Location's address.	STRING
area	Location's area. DEPRECATED, removed 2013-11-21. Replaced by: ...county field. Deprecated since: 2012-11-21.	STRING
city	Location's city.	STRING
country	Location's country.	STRING
country_code	Location's country code.	STRING
county	Location's county.	STRUCT
id	Entity's identifier.	STRING
name	Entity's name.	STRING
type	Entity's type.	STRING
description	Location's description.	STRING
latitude	Location's latitude.	STRING
longitude	Location's longitude.	STRING
timezone	Location's timezone.	STRING
zipcode	Location's zipcode.	STRING
name	Graph resource's name.	STRING
nickname	Viadeo nickname of the member. Can be used to replace the in the call. Usually [firstname].[lastname].	STRING
pending_request_id	Indicates the pending request id between the caller and this member.	STRING
picture_large	Link to the member's large picture.	STRING
picture_medium	Link to the member's medium picture.	STRING
picture_modification_date	Last modification date of the member's picture.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
picture_small	Indicates if the user has set a profile picture.	STRING
premium_since	Date the member is premium since.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
premium_until	User premium expiration date.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
profile_completion_score	Profil completion score.	INTEGER
twitter_accounts	The Twitter account names of the member.	[LIST] STRING
type	Graph resource's type.	STRING
updated_time	Graph resource's Last update date.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
webid	Member's id on the Viadeo website.	STRING
icon	The icon of the news.	STRING
id	Graph resource's ID.	STRING
infeed_link	Infeed link.	STRING
label	Type of the news generated by the member.	STRING
language	The language of the news.	STRING
like_count	Total count of the likes made on this news.	INTEGER
link	Link to the current Graph resource on Viadeo website.	STRING
message	Body of the news.	STRING
name	Graph resource's name.	STRING
on	The object which is related to this news – it’s type depends on news category. See complete list of news categories and refer to documentation of specific resources for more details.	STRUCT
id	Graph resource's ID.	STRING
link	Link to the current Graph resource on Viadeo website.	STRING
name	Graph resource's name.	STRING
type	Graph resource's type.	STRING
updated_time	Graph resource's Last update date.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
picture	URL of the header picture of the news if there is one.	STRING
real_link	Direct link to the shared article.	STRING
real_picture	Direct link to the picture of the shared article.	STRING
tags	Tags of the news.	[LIST] STRING
title	The title of the shared article.	STRING
to	Member who is recipient of the news. By using the ?user_detail= query parameter here, you will be able to retrieve more information on the user. Refer to the advanced API use section of the documentation.	STRUCT
birth_year	Year of birth of the member.	INTEGER
birthdate	Full date of birth of the member.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
contact_count	Member's number of contacts.	INTEGER
distance	Distance between the authenticated member and the viewed profile.	INTEGER
first_name	Member's first name.	STRING
gender	Gender of the member.	M\|F
has_picture	Indicates if the user has set a profile picture.	BOOLEAN
headline	Member's profile headline.	STRING
id	Graph resource's ID.	STRING
interests	List of the interests / hobbies of a member.	STRING
introduction	Member's profile introduction.	STRING
is_premium	Premium state of the member.	BOOLEAN
language	Language of this member's profile.	ISO-639
last_name	Member's last name.	STRING
link	Link to the current Graph resource on Viadeo website.	STRING
location	Member's location.	STRUCT
address	Location's address.	STRING
address_2	Location's address.	STRING
area	Location's area. DEPRECATED, removed 2013-11-21. Replaced by: ...county field. Deprecated since: 2012-11-21.	STRING
city	Location's city.	STRING
country	Location's country.	STRING
country_code	Location's country code.	STRING
county	Location's county.	STRUCT
id	Entity's identifier.	STRING
name	Entity's name.	STRING
type	Entity's type.	STRING
description	Location's description.	STRING
latitude	Location's latitude.	STRING
longitude	Location's longitude.	STRING
timezone	Location's timezone.	STRING
zipcode	Location's zipcode.	STRING
name	Graph resource's name.	STRING
nickname	Viadeo nickname of the member. Can be used to replace the in the call. Usually [firstname].[lastname].	STRING
pending_request_id	Indicates the pending request id between the caller and this member.	STRING
picture_large	Link to the member's large picture.	STRING
picture_medium	Link to the member's medium picture.	STRING
picture_modification_date	Last modification date of the member's picture.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
picture_small	Indicates if the user has set a profile picture.	STRING
premium_since	Date the member is premium since.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
premium_until	User premium expiration date.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
profile_completion_score	Profil completion score.	INTEGER
twitter_accounts	The Twitter account names of the member.	[LIST] STRING
type	Graph resource's type.	STRING
updated_time	Graph resource's Last update date.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
webid	Member's id on the Viadeo website.	STRING
type	Graph resource's type.	STRING
updated_time	Graph resource's Last update date.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
id	Graph resource's ID.	STRING
link	Link to the current Graph resource on Viadeo website.	STRING
name	Graph resource's name.	STRING
paging	Paging data.	STRUCT
next	Link to the next results's page.	STRING
previous	Link to the previous results's page.	STRING
type	Graph resource's type.	STRING
updated_time	Graph resource's Last update date.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]

List of connections

Connection path	Description

Resource: /<user_id>/home_newsfeed

GET /<user_id>/home_newsfeed

Example

Query parameters

Response [JSON] [XML]

List of connections