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",
    "subcategory":"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
    • subcategory: Subcategory 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":"Video",
    "subcategory":"TV shows"
  }
}