🚀 Introducing the Graphtracks Developer API (Beta)

Bluesky is growing, but until now, if you wanted structured analytics data you had few options:

Pull raw events from the AT Protocol firehose and build your own data pipeline.
Periodically query account data.
Or… not have analytics at all.

We’re fixing that.

Today we’re launching the Graphtracks Developer API (Beta) — the easiest way to get Bluesky engagement data into your apps, dashboards, and internal tools.

What’s in the API

With the Graphtracks API you can:

Query any Bluesky account and get stats over time (hour, day, week, month).
Access likes, reposts, replies, follows — without handling raw CAR files or lexicon plumbing.
Post level analytics - likes, reposts, replies
Top posts for period
Audience interactions
Historical data backfilling
Pull structured JSON via a simple REST API.

SDKs are ready to use today:

Want to build your own client ?

Welcome to our 📚 Docs → graphtracks.com/docs/api

Who It’s For

Bluesky client builders → add follower growth, engagement graphs, or trending insights directly into your app.
Growth app builders → skip months of infrastructure work, get production-ready data pipelines instantly.
Marketing & growth teams → integrate BlueSky analytics into existing BI dashboards or competitor monitoring workflows.
Researches → analyze social network effects, malicious behavior and trends.

Quickstart

Let’s imagine we want get follower growth data during specific week for account bsky.app with data aggregated by day. We will use nodejs and graphtracks js/ts client sdk to build small cli analytics app.

Initialize new npm project if you don’t have one. Open terminal and type.
```
mkdir bluesky-analytics
cd bluesky-analytics
npm init
```

Create get-stats.ts file that will utilize power of Graphtracks analytics API to get account follower stats. Script takes account did as an argument.

//get-stats.ts
const {
	BlueSkyAnalyticsApi,
	Configuration,
	Metric,
	Network,
	Timeframe
} = require('@graphtracks/client');

const did = process.argv[2];

// Initialize API client

const api = new BlueSkyAnalyticsApi(
	new Configuration({ apiKey: process.env.GRAPHTRACKS_API_KEY })
);

// Get followers stats for a given account

api
	.getGlobalStatsForAccount({
		network: Network.BlueSky, // Only Bluesky is supported
		accountId: did, // atproto account did
		metric: Metric.Followers, // Metric to query
		from: '2025-05-01', // Start date in UTC
		timeframe: Timeframe._7d, // relative amount of time since `from` to get
		bucket: 3600 * 24 // Interval between datapoints.
	})
	.then((res) => {
		console.log(res.data);
	});

Create new API key on www.graphtracks.com
Make sure GRAPHTRACKS_API_KEY environment variable is present
```
export GRAPHTRACKS_API_KEY=<api key from step 3>
```
Get account did by visiting bsky xrpc api https://bsky.social/xrpc/com.atproto.identity.resolveHandle?handle=bsky.app

Let’s run this script

node get-stats.js did:plc:z72i7hdynmk6r22z27h6tvur #bsky.app

Running this script will give you output:

[
	{ time: '2025-05-01 00:00:00', value: 30898 },
	{ time: '2025-05-02 00:00:00', value: 27199 },
	{ time: '2025-05-03 00:00:00', value: 26890 },
	{ time: '2025-05-04 00:00:00', value: 27511 },
	{ time: '2025-05-05 00:00:00', value: 28753 },
	{ time: '2025-05-06 00:00:00', value: 28346 },
	{ time: '2025-05-07 00:00:00', value: 27372 }
];

That’s it. Query, get JSON, build. Get answer in second.

Roadmap

This beta release gives you account-level and post-level engagement over time. Coming next:

Impressions (follow our #ATvision initiative)
Audience churn events (block, delete, mute, un-follow)
Webhooks for push-based, real-time monitoring
BI tools integration via Graphtracks API
API production readiness

Security

Our API does not require providing any bluesky password or additional access to bluesky account. Your account access is safe.

Disclaimer

⚠️ During Beta, our API is available for everyone on all plans. This will change in a feature when we figure or pricing model for API. The Service is provided as is with no SLA or guarantee.

Ready to Start Building?

The Graphtracks Developer API is ready for you to integrate Bluesky analytics into your applications. Whether you’re building a client, dashboard, or research tool, our API provides the structured data you need.

Get started today:

Sign up for free and create your account
Generate your API key in the developer dashboard
Explore the documentation to see all available endpoints
Join our community for support and updates

Discovery our postman api collection:

Start building with Bluesky analytics in minutes, not months. We can’t wait to see what you create! 🚀

Comment on Bluesky