Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

twitter

package module

Go to main page

Versions in this module

v0

v0.4.0

Aug 25, 2026

Changes in this version

+ const DefaultUserByScreenNameQueryID

+ const DefaultUserTweetsQueryID

type Client

+ UserByScreenNameQueryID string

+ UserTweetsQueryID string

+ func (c *Client) UserIDByScreenName(ctx context.Context, screenName string) (string, error)

+ func (c *Client) UserTweetsAuth(ctx context.Context, screenName string) (*Timeline, error)

+ func (c *Client) UserTweetsByID(ctx context.Context, userID string) (*Timeline, error)

type Option

+ func WithUserByScreenNameQueryID(id string) Option

+ func WithUserTweetsQueryID(id string) Option

v0.3.0

Aug 11, 2026

Changes in this version

+ const DefaultAPIBaseURL

+ const DefaultFollowingQueryID

+ const DefaultWebBearer

+ var ErrNeedsAuth = errors.New("twitter: the Following list needs a logged-in session (auth_token + ct0)")

+ var ErrQueryIDRotated = errors.New("twitter: the Following GraphQL query id rotated (404)")

type Client

+ APIBaseURL string

+ Bearer string

+ CSRFToken string

+ FollowingQueryID string

+ SessionAuthToken string

+ func (c *Client) Following(ctx context.Context, userID, cursor string) (*FollowingPage, error)

+ type FollowedUser struct

+ ID string

+ Name string

+ ScreenName string

+ type FollowingPage struct

+ Cursor string

+ Users []FollowedUser

type Option

+ func WithAPIBaseURL(u string) Option

+ func WithBearer(token string) Option

+ func WithFollowingQueryID(id string) Option

+ func WithSessionCookies(authToken, csrf string) Option

v0.2.0

Aug 8, 2026

Changes in this version

+ var ErrFingerprinted = errors.New(...)

+ var ErrNotFound = errors.New("twitter: no such account")

+ var ErrProtected = errors.New("twitter: account is protected")

+ type Link struct

+ Display string

+ Expanded string

+ URL string

type Media

+ AltText string

+ DurationMS int

+ Height int

+ Variants []VideoVariant

+ Width int

+ func (m Media) BestVariant() (v VideoVariant, ok bool)

type Tweet

+ Lang string

+ Links []Link

+ Quoted *Tweet

+ Quotes int

+ Retweeted *Tweet

+ Sensitive bool

+ User User

+ func (t Tweet) ExpandedText() string

+ func (t Tweet) Original() Tweet

+ func (t Tweet) PrimaryLink() string

+ type User struct

+ AvatarURL string

+ Description string

+ Followers int

+ ID string

+ Name string

+ Protected bool

+ ScreenName string

+ Verified bool

+ type VideoVariant struct

+ Bitrate int

+ ContentType string

+ URL string

v0.1.0

Jul 10, 2026

Changes in this version

+ const DefaultBaseURL

+ type Client struct

+ AuthToken string

+ BaseURL string

+ HTTPClient *http.Client

+ UserAgent string

+ func New(opts ...Option) *Client

+ func (c *Client) UserTweets(ctx context.Context, screenName string) (*Timeline, error)

+ type Media struct

+ Type string

+ URL string

+ type Option func(*Client)

+ func WithAuthToken(t string) Option

+ func WithBaseURL(u string) Option

+ func WithHTTPClient(h *http.Client) Option

+ func WithUserAgent(ua string) Option

+ type Timeline struct

+ Tweets []Tweet

+ type Tweet struct

+ Author string

+ CreatedAt time.Time

+ ID string

+ Likes int

+ Media []Media

+ Permalink string

+ Replies int

+ Retweets int

+ Text string