Skip to content

Get-TwitterTimeline

SYNOPSIS

Returns mentions or home timeline of the authenticating user, or a specified user's timeline.

SYNTAX

Mentions

Get-TwitterTimeline [-MentionsTimeline] [-Count <Int32>] [<CommonParameters>]

Home

Get-TwitterTimeline [-HomeTimeline] [-Count <Int32>] [<CommonParameters>]

User

Get-TwitterTimeline [-ScreenName <String>] [-UserId <String>] [-ExcludeRetweets] [-Count <Int32>] [<CommonParameters>]

DESCRIPTION

Returns the mentions or home timeline of the authenticating user, or a specified user's timeline.

EXAMPLES

Example 1

PS > Get-TwitterTimeline -MentionsTimeline -Count 5

Returns the last 5 mentions for the authenticating user.

Example 2

PS > Get-TwitterTimeline -HomeTimeline

Returns the last 20 Tweets for the authenticating user and the users they follow.

Example 3

PS > Get-TwitterTimeline -ScreenName rtpsug -Count 50

Returns the last 50 Tweets for the specified user and the users they follow.

PARAMETERS

-MentionsTimeline

Returns the mentions, Tweets containing the user's @screen_name, for the authenticating user.

Type: SwitchParameter
Parameter Sets: Mentions
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-HomeTimeline

Returns a collection of the most recent Tweets and Retweets posted by the authenticating user and the users they follow.

Type: SwitchParameter
Parameter Sets: Home
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ScreenName

The screen name of the user for whom to return results.

Type: String
Parameter Sets: User
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UserId

The ID of the user for whom to return results.

Type: String
Parameter Sets: User
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Count

The number of Tweets to return for the specified timeline.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ExcludeRetweets

By default, retweets are included. Use the ExcludeRetweets switch to omit retweets from the results.

Type: SwitchParameter
Parameter Sets: User
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

None

OUTPUTS

System.Object

NOTES

Online Version

API Documentation - GET statuses/mentions_timeline

API Documentation - GET statuses/home_timeline

API Documentation - GET statuses/user_timeline