Welcome to the Triathlon API
Developer Hub

Whether you are a researcher, media, or a fan, you'll find comprehensive guides and documentation to help you get up and running with the Triathlon API.

Get Started

Twitter Stream

The Twitter Stream endpoint provides a collated real-time feed of live tweets related to a live event. The Twitter stream provides live text commentary of a race via @triathlonlive as well as returning event specific hashtags e.g. #WTSEdmonton.

Twitter Stream Websocket Endpoint

wss://socket.triathlon.org/twitter

Tweet Object

A new Tweet object conforming to the below specifications will be delivered for every new Tweet.

{
   "user":{
      "id":15479044,
      "name":"in2recovery",
      "screen_name":"in2recovery",
      "profile_image_url":"https:\/\/pbs.twimg.com\/profile_images\/441834299021463552\/25Ka3gXw_normal.jpeg",
      "verified":true,
      "link":"https:\/\/twitter.com\/in2recovery"
   },
   "tweet":"From Addiction To Triathlon: Gary Schroeder explains how he beat his drink and drug habit to race Ironman UK <a href=\"https:\/\/t.co\/zc5xjwWf2J\" target=\"_blank\" rel=\"nofollow\">https:\/\/t.co\/zc5xjwWf2J<\/a>",
   "id":672127876091748352,
   "id_str":"672127876091748352",
   "source":"<a href=\"http:\/\/twitter.com\" rel=\"nofollow\">Twitter Web Client<\/a>",
   "created_at":"2015-12-02T18:59:07+0000",
   "timestamp":1449082747,
   "retweeted":false,
   "retweeted_user":null,
   "published":false,
   "media":null
}

Only verified Tweets will be published to the Twitter Streaming API which means they have either originated from a trusted source (e.g. @WorldTriathlon or @TriathlonLive account) or have passed through a manual moderation process.

Example

A very basic implementation of the Twitter Streaming API is available here.

Twitter Stream


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.