Skip to content

Torrent Data

Torrent event data is generated by our listeners on the DHT, and consist in a series of events indicating which peers are sharing which torrents from which nodes.

Accessible via:

  • Data Stream (Enterprise)
  • Web Portal
  • API

Schema

{
   "origin":{
      "type":"string",
      "module":"string",
      "ts":"int"
   },
   "node":{
      "ip":"string",
      "port":"int"
   },
   "peer":{
      "ip":"string",
      "port":"int"
   },
   "torrent":{
      "infohash":"string",
      "name":"string",
      "source":"string",
      "category":"string"
   }
}

Contents of the fields:

  • origin: Information about the event origin

    • type: Type of torrent event, can be "peer" or "node"
    • module: Static field, always "torrent", meant to distinguish from other events
    • ts: Timestamp of this event occurrence
  • node: Information about the node serving the torrent

    • ip: Node IP address
    • port: Node port
  • peer: Information about the peer downloading the torrent

    • ip: Peer IP address
    • port: Peer port
  • torrent: Information about the torrent itself

    • infohash: Infohash of this torrent transaction
    • name: Human readable name of the torrent
    • source: Source of the torrent (tracker)
    • category: Category of the torrent content

Event Example

{
   "origin":{
      "type":"peer",
      "module":"torrent",
      "ts":1538666957296
   },
   "node":{
      "ip":"xxx.xxx.xxx.xxx",
      "port":24357
   },
   "peer":{
      "ip":"xxx.xxx.xxx.xxx",
      "port":16138
   },
   "torrent":{
      "infohash":"a7e642b455ba9a2984537526d948f1845f8e0dfc",
      "name":"The Ultimate Fighter S28E06 720p FOX WEB-DL AAC2 0 H 264-BOOP EZTV",
      "source":"EZTV",
      "category":"TV Show"
   }
}