gotwtr icon indicating copy to clipboard operation
gotwtr copied to clipboard

gotwtr provides Twitter v2 API

gotwtr

Go Reference codecov reviewdog test

gotwtr is a Go client library for the Twitter v2 API.

Note

We covers only Twitter v2 API supported by OAuth 2.0 Bearer Token.

We will had worked on it, when new one is be handled OAuth 2.0.

Features

Tweet

  • Tweet lookup
  • Timelines
  • Search Tweets
  • Tweet Counts
  • Filtered Stream
  • Volume Streams
  • Retweets
  • Likes

Lists

  • List lookup
  • List Tweets lookup
  • List members
  • List follows

Users

  • User lookup
  • Follows

Spaces

  • Space lookup
  • Search spaces

Installation

go get github.com/sivchari/gotwtr

Documentation

Please see GoDoc

Example

Tweet lookup

package main

import (
	"context"
	"fmt"

	"github.com/sivchari/gotwtr"
)

func main() {
	client := gotwtr.New("YOUR_TWITTER_BEARER_TOKEN")
	// look up multiple tweets
	ts, err := client.RetrieveMultipleTweets(context.Background(), []string{"id", "id2"})
	if err != nil {
		panic(err)
	}
	for _, t := range ts.Tweets {
		fmt.Println(t)
	}

	// look up single tweet
	t, err := client.RetrieveSingleTweet(context.Background(), "id")
	if err != nil {
		panic(err)
	}
	fmt.Println(t.Tweet)
}

If you wanna more example, please see examples dir.

These are covered all code gotwtr provides Twitter v2 API interface.

Contributing

We are welcome to contribute to this project.

Fork and make a Pull Request, or create an Issue if you see any problem or any enhancement, feature request.