Documentation » API » Methods » newsfeed.get

Returns the current user’s followees’ updates (and their own posts).

This method requires the following permissions: newsfeed.

Parameters

filters
string

Which types of updates to return, comma-separated string:

  • post – wall posts and reposts
  • photo – new photos added to albums
  • photo_tag – new photo tags
  • friend – new friends
  • group – groups joined or created
  • event – events joined or created
  • board – new discussion board topics in groups
  • relation – relationship status changes

By default, updates of all types are returned.

return_banned
boolean

Whether to include updates from muted users.

By default false.

start_from
string

An opaque string required for pagination, returned as next_from by the previous call of this method. Don’t pass this parameter when loading the news feed for the first time or refreshing it.

count
integer (1..100)

How many updates to return.

By default 25.

Result

An object:

items
array of objects

The updates themselves.

type
enum
  • board – The user created some discussion board topics.
  • event_create – The user created some events.
  • event_join – The user joined some events.
  • friend – The user added new friends.
  • group_create – The user created some groups.
  • group_join – The user joined some groups.
  • photo – New photos were uploaded.
  • photo_tag – The user was tagged in some photos.
  • post – A new wall post was created.
  • relation – The user has changed their relationship status.
id
integer (positive)

Identifier of this update.

user_id
integer (positive)

Which user this update is about.

post
WallPost

When type is post, a wall post object.

photos
object

When type is photo or photo_tag, information about those photos.

count
integer (positive)

How many photos were added or tagged in total.

items
array of photos

Up to 10 photo objects.

list_id
string

An identifier to retrieve the complete list of photos that were added or tagged using photos.getFeedEntry.

friend_ids
array of integers

When type is friend, an array of user identifiers for newly added friends.

group_ids
array of integers

When type is group_join, group_create, event_join or event_create, an array of group identifiers.

topics
array of BoardTopics

When type is board, an array of topic objects.

relation
object

When type is relation, information about the relationship status change.

status
enum

The new relationship status.

Possible values: actively_searching, complicated, engaged, in_love, in_relationship, married, single.

partner
integer (positive)

The new partner user identifier, if any.

profiles
array of users

User objects relevant to these updates.

groups
array of groups

Group objects relevant to these updates.

next_from
string

The value to pass as start_from in a subsequent call to this method to load the next page of the news feed.

If this field is absent, no more updates are available.

Errors

Global errors may occur when calling this method.