Go

go get github.com/tsirysndr/rocksky/sdk/go/rocksky

package main

import (
    "context"
    "fmt"

    "github.com/tsirysndr/rocksky/sdk/go/rocksky"
)

func main() {
    client := rocksky.NewClient()

    profile, err := client.Actor.GetProfile(context.Background(), rocksky.GetProfileParams{
        Actor: "tsiry.bsky.social",
    })
    if err != nil {
        panic(err)
    }
    fmt.Printf("@%s (%s)\n", profile.Handle, profile.DID)
}

client := rocksky.NewClient(
    rocksky.WithBearerToken(os.Getenv("ROCKSKY_TOKEN")),
)

_, err := client.Scrobble.CreateScrobble(ctx, rocksky.CreateScrobbleInput{
    Title:     "Black Hole Sun",
    Artist:    "Soundgarden",
    Album:     "Superunknown",
    Duration:  320000, // ms
    Timestamp: time.Now().Unix(),
})

client.Actor    // app.rocksky.actor.*
client.Album    // app.rocksky.album.*
client.Artist   // app.rocksky.artist.*
client.Song     // app.rocksky.song.*
client.Scrobble // app.rocksky.scrobble.*
client.Charts   // app.rocksky.charts.*
client.Stats    // app.rocksky.stats.*
client.Feed     // app.rocksky.feed.*
client.Graph    // app.rocksky.graph.*
client.Like     // app.rocksky.like.*
client.Shout    // app.rocksky.shout.*

// Write op with lots of optional metadata
out, err := client.Scrobble.NewScrobble("Black Hole Sun", "Soundgarden").
    Album("Superunknown").
    Duration(320_000).
    ISRC("USXXX1234567").
    Year(1994).
    Timestamp(time.Now().Unix()).
    Send(ctx)

// Multi-filter query
chart, err := client.Charts.NewScrobblesChart().
    Actor("tsiry.bsky.social").
    From("2025-01-01").
    To("2025-12-31").
    Do(ctx)

// Shouts and replies
shout, err := client.Shout.NewShout("listening to this on repeat").Send(ctx)
reply, err := client.Shout.NewReply(parentURI, "agreed!").Send(ctx)

_, err := client.Scrobble.CreateScrobble(ctx, in)
var apiErr *rocksky.Error
if errors.As(err, &apiErr) && apiErr.IsRateLimited() {
    // back off and retry
}