Download OpenAPI specification:
Bluesky Analytics API for GraphTracks
Get growth rate statistics for account. Timeframe, from or to must be provided.
|
network
required
|
string
(network)
Value:
"BlueSky"
The network to get stats for. Only BlueSky is supported right now. |
|
account_id
required
|
string
(account_id)
The account id to get stats for. This is the did of the account for BlueSky. |
|
metric
required
|
string
(metric)
Enum:
"followers"
"likes"
"replies"
"reposts"
"engagement"
The metric to get stats for |
| timeframe |
string
(timeframe)
Enum:
"1h"
"1d"
"7d"
"30d"
"90d"
"all"
The timeframe to get stats for. If to and from are not provided, will return now - Timeframe. |
| from |
string
<date-time>
(from)
The start date of the timeframe. Expects a datetime of the post. UTC timezone. |
| to |
string
<date-time>
(from)
The end date of the timeframe. If not provided, timeframe and from must be provided. |
| bucket |
integer
Default:
3600
Example:
bucket=3600
bucket size. Interval in seconds between data points. Data points will be aggregated into this bucket size. |
[
-
{
-
"time":
"2019-08-24T14:15:22Z",
-
"value":
0
}
]
Create a network account for the authenticated user.
|
account_handle
required
|
string
The account handle to create (e.g., 'graphtracks.com') |
| network |
string
Default:
"BlueSky"
Value:
"BlueSky"
The network to create an account for. Only BlueSky is supported right now. |
{
-
"account_handle":
"graphtracks.com",
-
"network":
"BlueSky"
}
{
-
"account_id":
"did:plc:z72i7hdynmk6r22z27h6tvur",
-
"account_handle":
"graphtracks.com",
-
"account_internal_id": 0,
-
"active":
true,
-
"created_at":
"2019-08-24T14:15:22Z",
-
"updated_at":
"2019-08-24T14:15:22Z",
-
"network":
"BlueSky"
}
Get all network accounts associated with the authenticated user.
[
-
{
-
"account_id":
"did:plc:z72i7hdynmk6r22z27h6tvur",
-
"account_handle":
"graphtracks.com",
-
"account_internal_id": 0,
-
"active":
true,
-
"created_at":
"2019-08-24T14:15:22Z",
-
"updated_at":
"2019-08-24T14:15:22Z",
-
"network":
"BlueSky"
}
]
Get details for a specific network account.
|
account_id
required
|
string
Example:
did:plc:z72i7hdynmk6r22z27h6tvur
The account id to get or delete. This is the did of the account for BlueSky. |
{
-
"account_id":
"did:plc:z72i7hdynmk6r22z27h6tvur",
-
"account_handle":
"graphtracks.com",
-
"account_internal_id": 0,
-
"active":
true,
-
"created_at":
"2019-08-24T14:15:22Z",
-
"updated_at":
"2019-08-24T14:15:22Z",
-
"network":
"BlueSky"
}
Delete a network account from your GraphTracks account.
|
account_id
required
|
string
Example:
did:plc:z72i7hdynmk6r22z27h6tvur
The account id to get or delete. This is the did of the account for BlueSky. |
{
-
"message":
"Network account deleted"
}
Get time series statistics for a specific post. Requires metric, timeframe, and from parameters.
|
network
required
|
string
(network)
Value:
"BlueSky"
The network to get stats for. Only BlueSky is supported right now. |
|
account_id
required
|
string
(account_id)
The account id that owns the post. This is the did of the account for BlueSky. |
|
post_id
required
|
string
(post_id)
Example:
3k4duaz5vfs2b
The post id to get stats for |
|
metric
required
|
string
(metric)
Enum:
"followers"
"likes"
"replies"
"reposts"
"engagement"
The metric to get stats for |
|
timeframe
required
|
string
(timeframe)
Enum:
"1h"
"1d"
"7d"
"30d"
"90d"
"all"
The timeframe to get stats for |
|
from
required
|
string
<date-time>
(from)
The start date of the timeframe |
| bucket |
integer
Default:
3600
Example:
bucket=3600
Bucket size. Interval in seconds between data points. Data points will be aggregated into this bucket size. |
[
-
{
-
"time":
"2019-08-24T14:15:22Z",
-
"value":
0
}
]
Get the top performing posts for an account within a specified timeframe.
|
network
required
|
string
(network)
Value:
"BlueSky"
The network to get stats for. Only BlueSky is supported right now. |
|
account_id
required
|
string
(account_id)
The account id to get top posts for. This is the did of the account for BlueSky. |
| timeframe |
string
(timeframe)
Enum:
"1h"
"1d"
"7d"
"30d"
"90d"
"all"
The timeframe to analyze for top posts |
| limit |
integer
Default:
10
Example:
limit=10
Maximum number of top posts to return |
[
-
{
-
"post_id":
"3k4duaz5vfs2b",
-
"likes":
0,
-
"reposts":
0,
-
"replies":
0,
-
"engagement": 0,
-
"details":
{ },
-
"indexedAt":
"2019-08-24T14:15:22Z"
}
]
Get detailed interaction data for a specific post, including user profiles who interacted.
|
network
required
|
string
(network)
Value:
"BlueSky"
The network to get stats for. Only BlueSky is supported right now. |
|
account_id
required
|
string
(account_id)
The account id that owns the post. This is the did of the account for BlueSky. |
|
post_id
required
|
string
(post_id)
Example:
3k4duaz5vfs2b
The post id to get interactions for |
|
metric
required
|
string
(metric)
Enum:
"followers"
"likes"
"replies"
"reposts"
"engagement"
The type of interaction to retrieve |
|
timeframe
required
|
string
(timeframe)
Enum:
"1h"
"1d"
"7d"
"30d"
"90d"
"all"
The timeframe to get interactions for |
|
from
required
|
string
<date-time>
(from)
The start date of the timeframe |
| to |
string
<date-time>
(from)
The end date of the timeframe |
| limit |
integer
Default:
10
Example:
limit=10
Maximum number of interactions to return |
| offset |
integer
Example:
offset=0
Offset for pagination |
| sort |
string
Default:
"desc"
Enum:
"asc"
"desc"
Sort order for interactions |
[
-
{
-
"time":
"2019-08-24T14:15:22Z",
-
"id":
"string",
-
"profile":
{ }
}
]