forked from
microcosm.blue/microcosm-rs
Constellation, Spacedust, Slingshot, UFOs: atproto crates and services for microcosm
refer api docs to live instance for now
+18
-1
+18
-1
constellation/readme.md
+18
-1
constellation/readme.md
···
1
1
# constellation 🌌
2
2
3
-
## endpoints
3
+
A global atproto backlink index ✨
4
+
5
+
- Self hostable: handles the full write throughput of the global atproto firehose on a raspberry pi 4b + single SSD
6
+
- Storage efficient: less than 2GB/day disk consumption indexing all references in all lexicons and all non-atproto URLs
7
+
- Simple JSON API
8
+
9
+
All social interactions in atproto tend to be represented by links (or references) between PDS records. This index can answer questions like "how many likes does a bsky post have", "who follows an account", "what are all the comments on a [frontpage](https://frontpage.fyi/) post", and more.
10
+
11
+
- **status**: works! api is unstable and likely to change, and no known instances have a full network backfill yet.
12
+
- source: [./constellation/](./constellation/)
13
+
- public instance: [links.bsky.bad-example.com](https://links.bsky.bad-example.com/)
14
+
15
+
_note: the public instance currently runs on a little raspberry pi in my house, feel free to use it! it comes with only with best-effort uptime, no commitment to not breaking the api for now, and possible rate-limiting. if you want to be nice you can put your project name and bsky username (or email) in your user-agent header for api requests._
16
+
17
+
18
+
## API endpoints
19
+
20
+
currently this is a bit out of date -- refer to the [api docs hosted by the app itself](https://links.bsky.bad-example.com/) for now. they also let you try out live requests.
4
21
5
22
terms as used here:
6
23