Go SDK

go get github.com/ScrapingIsNotACrime/sdk-go

package main

import (
	"context"
	"errors"
	"fmt"
	"log"

	sinac "github.com/ScrapingIsNotACrime/sdk-go"
)

func main() {
	client, err := sinac.NewClient(sinac.WithAPIKey("sinac_..."))
	if err != nil {
		log.Fatal(err)
	}

	profile, err := client.Instagram.Profile(context.Background(), "nasa")
	if errors.Is(err, sinac.ErrNotFound) {
		fmt.Println("no such profile")
		return
	}
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(profile.Username, profile.Followers)
}

client, err := sinac.NewClient(
	sinac.WithAPIKey("sinac_..."),
	sinac.WithBaseURL("https://api.scrapingisnotacrime.com/v1"),
	sinac.WithTimeout(30*time.Second),
	sinac.WithMaxRetries(2),
	sinac.WithHTTPClient(nil),
)

page, err := client.GitHub.Followers(ctx, "torvalds", &sinac.GitHubListParams{Limit: 100})
if err != nil {
	log.Fatal(err)
}

n := 0
for user, err := range page.All(ctx) {
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(user.Username)
	if n++; n >= 250 {
		break // stop early; no further pages are fetched
	}
}

page, err := client.Bluesky.Posts(ctx, "bsky.app", &sinac.BlueskyPostsParams{Limit: 25})
// Each page fetched is one billed request, so stop after a bounded number of pages.
for fetched := 0; page != nil && err == nil && fetched < 3; fetched++ {
	for _, post := range page.Items {
		fmt.Println(post.Text)
	}
	page, err = page.Next(ctx)
}
if err != nil {
	log.Fatal(err)
}

var apiErr *sinac.Error
if errors.As(err, &apiErr) {
	fmt.Println(apiErr.Status, apiErr.RequestID)
}

profile, err := client.TikTok.Profile(ctx, "this-user-does-not-exist-123")
switch {
case errors.Is(err, sinac.ErrNotFound):
	fmt.Println("no such profile")
case errors.Is(err, sinac.ErrQuotaExceeded):
	log.Fatal(err) // includes the pricing link in Message
case errors.Is(err, sinac.ErrRateLimit):
	fmt.Println("TikTok is rate limiting; already retried, try again later")
case err != nil:
	log.Fatal(err)
default:
	fmt.Println(profile.Username)
}