Public API

Why or when to use the API

• Protect your own network. Monitor your own IP address to detect whether someone on your network is downloading torrents. Any torrent activity tied to your IP is visible in the public record and can be checked at any time.
• Verify activity for an address you are responsible for. If a specific IP address is used by people you know (a household, a workplace, a shared connection), the API lets you see which torrents were associated with it - and therefore what others may be downloading on that connection.
• Automate monitoring. The API is designed to be called from scripts. Poll a set of IP addresses and have your script notify you the moment new download activity is recorded for any of them - no manual checking required.
• Research and statistics. Aggregate the public leaderboards, peer counts and client data for transparency research, journalism or simply to understand what is being shared on BitTorrent.

Note: torrent activity is public by design - any peer in a swarm can observe it. The API simply exposes that public record in a machine-readable form. Be aware that IP addresses are shared between devices and users (NAT, CGNAT, Wi-Fi hotspots), so activity on an IP is not necessarily proof of a specific person.

Acceptable Use

• GET requests only - POST, PUT, DELETE etc. are never accepted on the public API.
• The API stays free and open - send requests straight from curl, Python, JavaScript, anything. No account needed for the standard (redacted) data.
• Base URL: https://AnyoneCanSeeWhatYou.download
• Responses are JSON: { "success": true, "data": { ... } } (errors use success: false + error).
• IP addresses in peer lists are redacted to the last octet (e.g. 1.1.1.1 → 1.1.1.x).
• Unredacted IP addresses require a free account + API key. Create a FREE monitoring account, copy your API key from the dashboard, and pass it as ?key=YOUR_KEY or Authorization: Bearer YOUR_KEY - peer lists then return the full IP addresses. Create a free account →
• Fair use: data endpoints are limited to 120 requests/minute per IP. The frontend's own endpoints (summary/leaderboards/active/feed) are exempt.
• If your project genuinely requires a higher rate limit, please email [email protected] explaining your use case and why you need a larger allowance. Requests are reviewed on a case-by-case basis.
• AnyoneCanSeeWhatYou.download cannot and will not share .torrent files or magnet URIs with anyone. These are not stored by the service - the API only returns metadata, info hashes and links to this site's own pages.

Endpoints

Examples

curl "https://AnyoneCanSeeWhatYou.download/api/public/torrents?limit=5"

curl "https://AnyoneCanSeeWhatYou.download/api/public/dht-nodes?limit=3"
# {"success":true,"data":{"nodes":[{"ip":"1.2.3.4","port":6881,"last_seen":42,
#   "country":"NL","country_name":"The Netherlands","city":"Amsterdam",
#   "asn":1136,"as_org":"KPN B.V.","uptime":98.2},...],
#   "total":7013,"live":7012,"countries":150,"avg_uptime":87.4}}

import requests
r = requests.get("https://AnyoneCanSeeWhatYou.download/api/public/peers", params={"limit": 10})
data = r.json()["data"]
for p in data["peers"]:
    print(p["ip"], p["client"], p["torrent"])

const res = await fetch("https://AnyoneCanSeeWhatYou.download/api/public/countries?limit=5");
const data = (await res.json()).data;
data.countries.forEach(c => console.log(c.country_name, c.unique_ips));