deCloudflare/subfiles/service/karma_api.md
Malavika Balachandran Tadeusz 8749b5d751 .
2023-09-11 23:06:03 +00:00

64 lines
3.5 KiB
Markdown

## Karma API
- Operated by `Crimeflare #Karma` with `No log` policy.
- There is a rate-limit and anti-attack system so please be nice.
There are many wide-range APIs live on Karma.
In this page we explain some of read-only APIs.
Replace the `(base url)` to:
| Type | URL |
| -- | -- |
| Clearnet | `https://karma.crimeflare.eu.org/api/` |
| Tor | `http://karma.im5wixghmfmt7gf7wb4xrgdm6byx2gj26zn47da6nwo7xvybgxnqryid.onion/api/` |
----
### Cloudflare Domains Lookup
- List data is almost identical to [this git data](http://crimeflare.eu.org).
- For looking up domain's existence as a [MITM domain](../../cloudflare_users/domains/README.md).
- Also try: `Listed as Cloudflare` website
- [Clearnet](https://karma.crimeflare.eu.org/api/is/cloudflare/html/)
- [Tor](http://karma.im5wixghmfmt7gf7wb4xrgdm6byx2gj26zn47da6nwo7xvybgxnqryid.onion/api/is/cloudflare/html/)
| ? | ? |
| -- | -- |
| Location | `(base url)is/cloudflare/` |
| Request Method | `POST` |
| Input | **Single Question**<br>`f` or `u` is required. `ignore_cfowned` is optional.<br>`f` FQDN (e.g. `www.google.com`)<br>`u` URL (e.g. `https://www.google.com/`)<br>`ignore_cfowned` Existence (If set, return FALSE when the domain is owned by CloudFlare Inc.)<br><br>**Multiple Questions** (max 200 domains)<br>`ff` is required. `ignore_cfowned` is optional.<br>`ff` List of FQDN separated by `,` (e.g. `www.google.com,blog.emsisoft.com,youtu.be`)<br>`ignore_cfowned` Existence (If set, return FALSE when the domain is owned by CloudFlare Inc.) |
| Output | JSON value as array.<br>**Single Question**<br>If 2nd value(j[1]) is true then the input is Cloudflare.<br>`[false,false]` (Error or not Cloudflare)<br>`[true,false]` (Not Cloudflare)<br>`[true,true]` (Cloudflare)<br><br>**Multiple Questions**<br>Array pair of `question:true\|false`.<br>`{'example.com':false,...}` (Not Cloudflare)<br>`{'example.com':true,...}` (Cloudflare) |
| cURL Example | `curl -X POST -F 'f=www.example.com' -k --http2 https://clearnet/api/is/cloudflare/`<br>`curl -x socks5h://127.0.0.1:9050 -X POST -F 'f=www.example.com' http://onion/api/is/cloudflare/`<br>`curl -X POST -F 'ff=www.emsisoft.com,joinmastodon.org,framagit.org' -k --http2 https://clearnet/api/is/cloudflare/` |
----
### Anti-Tor Lookup
- List data is almost identical to [this git data](http://crimeflare.eu.org).
- For looking up website's existence in the [known Anti-Tor list](../../anti-tor_users/domains/README.md).
| ? | ? |
| -- | -- |
| Location | `(base url)is/antitor/` |
| Request Method | `POST` |
| Input | `f` is required.<br>`f` FQDN (e.g. `www.google.com`) |
| Output | JSON value as array. If 2nd value(j[1]) is true then the input is AntiTor.<br>`[false,false]` (Error or not AntiTor)<br>`[true,false]` (Not AntiTor)<br>`[true,true]` (AntiTor) |
| cURL Example | `curl -X POST -F 'f=www.example.com' -k --http2 https://clearnet/api/is/antitor/`<br>`curl -x socks5h://127.0.0.1:9050 -X POST -F 'f=www.example.com' http://onion/api/is/antitor/` |
----
### Get Data
- Get data in simple format.
- For your automation use.
| ? | ? |
| -- | -- |
| Location | `(base url)listdata/` |
| Request Method | `GET` |
| Input | `name` is required.<br>`name` string (e.g. `cf_fediverse`)<br>possible values:<br>`cf_fediverse` JSON [Cloudflared Fediverse](../cloudflared/social/fediverse.md) Domain<br>`cf_fediverse_CSV` Text<br>`cf_fediverse_FQDN` JSON Cloudflared Fediverse FQDN<br>`cf_fediverse_FQDN_CSV` Text<br> |
| Output | JSON or Text |
| cURL Example | `curl -k --http2 https://clearnet/api/listdata/?name=cf_fediverse` |