Zum Inhalt springen
GET /v1/relays

Search the public relay list

Live testen

10 freie Calls pro Tag — keine Anmeldung, kein API-Key. Geht durchs oanor-Gateway.

Eigene Header (optional)
api.oanor.com/tor-api

Funktioniert. Hol dir einen API-Key und nutze sie in deinem Projekt.

API-Key holen

Code-Snippets

curl "https://api.oanor.com/tor-api/v1/relays" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/tor-api/v1/relays", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/tor-api/v1/relays");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/tor-api/v1/relays",
    headers={"x-oanor-key": "oanor_test_..."}
)

Beispiel-Response

Echte Antwort dieses Endpoints, erfasst beim letzten Health-Check.

{
    "data": {
        "count": 20,
        "limit": 20,
        "query": {
            "flag": "Exit",
            "search": null,
            "country": null,
            "running": null
        },
        "offset": 0,
        "relays": [
            {
                "as": "AS399820",
                "flags": [
                    "Exit",
                    "Fast",
                    "Guard",
                    "HSDir",
                    "Running",
                    "Stable",
                    "V2Dir",
                    "Valid"
                ],
                "as_name": "SPARKED HOST LLC",
                "country": "us",
                "is_exit": true,
                "running": true,
                "is_guard": true,
                "nickname": "SENDNOOSEplz",
                "last_seen": "2026-06-01 22:00:00",
                "first_seen": "2026-04-06 23:00:00",
                "fingerprint": "000F3EB75342BE371F1D8D3FAE90890AEB5664EE",
                "country_name": "United States of America",
                "or_addresses": [
                    "204.137.14.106:443"
                ],
                "bandwidth_rate": 12697600,
                "exit_addresses": [
                    "204.137.14.106"
                ],
                "exit_policy_summary": {
                    "accept": [
                        "20-23",
                        "43",
                        "53",
                        "79-81",
                        "88",
                        "110",
                        "143",
                        "194",
                        "220",
                        "389",
                        "443",
                        "464-465",
                        "531",
                        "543-544",
                        "554",
                        "563",
                        "587",
                        "636",
                        "706",
                        "749",
                        "873",
                        "902-904",
                        "981",
                        "989-995",
                        "1194",
                        "1220",
                        "1293",
                        "1500",
                        "1533",
                        "1677",
                        "1723",
                        "1755",
                        "1863",
                        "2082-2083",
                        "2086-2087",
                        "2095-2096",
                        "2102-2104",
                        "3128",
                        "3389",
                        "3690",
                        "4321",
                        "4643",
                        "5050",
                        "5190",
                        "5222-5223",
                        "5228",
                        "5900",
                        "6660-6669",
                        "6679",
                        "6697",
                        "8000",
          
…