go-birdsite

Pure-Go best-effort read client for public Twitter/X profile timelines.

CGO_ENABLED=0 zero third-party deps standard library only best-effort · fragile BSD-3-Clause
Documentation GitHub

A pure-Go (CGO=0), dependency-free, best-effort read client for public Twitter/X profile timelines. It reads the public syndication timeline endpoint that powers embedded timeline widgets and extracts tweets from the __NEXT_DATA__ JSON blob.

⚠️ Best-effort — expect breakage

This is inherently fragile. Twitter/X changes and locks these endpoints, and many profiles or rate states require a valid auth token.

Blocked requests (403/429) surface as errors — they indicate blocking and fragility, not a bug in the code. Respect Twitter/X's Terms of Service and applicable law when using this library.

Usage

Pure Go, standard library only. go get github.com/go-birdsite/twitter

c := twitter.New()

tl, err := c.UserTweets(context.Background(), "jack")
if err != nil {
	panic(err) // 403/429 here means Twitter/X is blocking the request.
}
for _, tw := range tl.Tweets {
	fmt.Printf("@%s: %s (%d likes)\n", tw.Author, tw.Text, tw.Likes)
}

Repositories

Everything that actually exists in the org today.

twitter client

Pure-Go best-effort read client for public Twitter/X profile timelines.

CI Go Reference

brand brand

Logos, icons and social images for go-birdsite.