2023-06-24 00:23:53 +00:00
# Fediseer
2023-06-21 00:16:11 +00:00
2023-06-24 00:23:53 +00:00
This service provides an REST API which can be used to retrieve various information about Fediverse instances, particularly focused on detecting and countering bad actors.
2023-06-21 00:16:11 +00:00
It's reliant on the [Lemmy Fediverse Observer ](https://lemmy.fediverse.observer/ )
2023-06-24 00:23:53 +00:00
The currently running instance is on https://fediseer.com
2023-06-22 17:41:46 +00:00
2023-06-27 14:11:51 +00:00
See devlog: https://dbzer0.com/blog/overseer-a-fediverse-chain-of-trust/
2023-08-09 14:20:10 +00:00
# Libraries
We provide a Python library to interact programmatically with the fediseer api: [Pythonseer ](https://github.com/db0/pythonseer )
2023-06-27 14:11:51 +00:00
# Badges
You can retrieve and display a badge for your fediverse domain by requesting a .svg for it on a special endpoint
`/v1/badges/guarantees/{domain}.svg` will give you an badge of guarantee, mentioning the domains which guaranteed for your domain
2023-06-27 14:19:56 +00:00
Example: [![ ](http://fediseer.com/api/v1/badges/guarantees/lemmy.dbzer0.com.svg )](https://fediseer.com/api/v1/whitelist/lemmy.dbzer0.com)
2023-06-27 14:11:51 +00:00
2023-06-27 14:19:56 +00:00
```markdown
[![ ](http://fediseer.com/api/v1/badges/guarantees/lemmy.dbzer0.com.svg )](https://fediseer.com/api/v1/whitelist/lemmy.dbzer0.com)`
```
2023-06-27 14:11:51 +00:00
2023-06-27 14:19:56 +00:00
`/v1/badges/endorsements/{domain}.svg` will give you an badge of endorsements, providing a count of how many other fediverse domains guaranteed for yours
Example: [![ ](http://fediseer.com/api/v1/badges/endorsements/lemmy.dbzer0.com.svg )](https://fediseer.com/api/v1/endorsements/lemmy.dbzer0.com)
```markdown
[![ ](http://fediseer.com/api/v1/badges/endorsements/lemmy.dbzer0.com.svg )](https://fediseer.com/api/v1/endorsements/lemmy.dbzer0.com)`
2023-08-09 14:20:10 +00:00
```