{"_id":"564b8548cc472d0d00da945b","user":"546d17e2eb9cfd1400dd4529","__v":15,"category":{"_id":"55773b0407e7110d001043f1","project":"55773a5ba042551900b002cb","pages":["564b851685e4e92b00fb4fa2","564b853adda79a19000f2670","564b8548cc472d0d00da945b"],"version":"55773a5ba042551900b002ce","__v":3,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-06-09T19:14:12.710Z","from_sync":false,"order":13,"slug":"streaming-api","title":"Streaming API"},"version":{"_id":"55773a5ba042551900b002ce","project":"55773a5ba042551900b002cb","__v":18,"createdAt":"2015-06-09T19:11:23.764Z","releaseDate":"2015-06-09T19:11:23.764Z","categories":["55773a5ca042551900b002cf","55773a6ce6063e0d00481380","55773ab007e7110d001043ec","55773abaa042551900b002d5","55773ac207e7110d001043ed","55773acb07e7110d001043ee","55773ad3a042551900b002d6","55773adce6063e0d00481383","55773ae4a042551900b002d7","55773af307e7110d001043ef","55773af907e7110d001043f0","55773b0407e7110d001043f1","563a4f7ad25e8919005f3f39","563a4fcaa19edf0d00972321","564a70dc4cd0521700523edf","564b797bcc472d0d00da9435","564b855b766d4923004e1fd1","59cd4b81935249001c77c48e"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"Motherboard","version_clean":"1.0.0","version":"1"},"parentDoc":null,"project":"55773a5ba042551900b002cb","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-11-17T19:51:36.300Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"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 :::at:::triathlonlive as well as returning event specific hashtags e.g. #WTSEdmonton.\n[block:callout]\n{\n  \"type\": \"success\",\n  \"body\": \"**wss://socket.triathlon.org/twitter**\",\n  \"title\": \"Twitter Stream Websocket Endpoint\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Tweet Object\"\n}\n[/block]\nA new Tweet object conforming to the below specifications will be delivered for every new Tweet.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n   \\\"user\\\":{\\n      \\\"id\\\":15479044,\\n      \\\"name\\\":\\\"in2recovery\\\",\\n      \\\"screen_name\\\":\\\"in2recovery\\\",\\n      \\\"profile_image_url\\\":\\\"https:\\\\/\\\\/pbs.twimg.com\\\\/profile_images\\\\/441834299021463552\\\\/25Ka3gXw_normal.jpeg\\\",\\n      \\\"verified\\\":true,\\n      \\\"link\\\":\\\"https:\\\\/\\\\/twitter.com\\\\/in2recovery\\\"\\n   },\\n   \\\"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>\\\",\\n   \\\"id\\\":672127876091748352,\\n   \\\"id_str\\\":\\\"672127876091748352\\\",\\n   \\\"source\\\":\\\"<a href=\\\\\\\"http:\\\\/\\\\/twitter.com\\\\\\\" rel=\\\\\\\"nofollow\\\\\\\">Twitter Web Client<\\\\/a>\\\",\\n   \\\"created_at\\\":\\\"2015-12-02T18:59:07+0000\\\",\\n   \\\"timestamp\\\":1449082747,\\n   \\\"retweeted\\\":false,\\n   \\\"retweeted_user\\\":null,\\n   \\\"published\\\":false,\\n   \\\"media\\\":null\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\nOnly verified Tweets will be published to the Twitter Streaming API which means they have either originated from a trusted source (e.g. [@WorldTriathlon](https://twitter.com/worldtriathlon) or @[TriathlonLive](https://twitter.com/triathlonlive) account) or have passed through a manual moderation process.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Example\"\n}\n[/block]\nA very basic implementation of the Twitter Streaming API is available [here](https://world-triathlon.github.io/twitter-sample.html).","excerpt":"","slug":"twitter-stream","type":"basic","title":"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. [block:callout] { "type": "success", "body": "**wss://socket.triathlon.org/twitter**", "title": "Twitter Stream Websocket Endpoint" } [/block] [block:api-header] { "type": "basic", "title": "Tweet Object" } [/block] A new Tweet object conforming to the below specifications will be delivered for every new Tweet. [block:code] { "codes": [ { "code": "{\n \"user\":{\n \"id\":15479044,\n \"name\":\"in2recovery\",\n \"screen_name\":\"in2recovery\",\n \"profile_image_url\":\"https:\\/\\/pbs.twimg.com\\/profile_images\\/441834299021463552\\/25Ka3gXw_normal.jpeg\",\n \"verified\":true,\n \"link\":\"https:\\/\\/twitter.com\\/in2recovery\"\n },\n \"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>\",\n \"id\":672127876091748352,\n \"id_str\":\"672127876091748352\",\n \"source\":\"<a href=\\\"http:\\/\\/twitter.com\\\" rel=\\\"nofollow\\\">Twitter Web Client<\\/a>\",\n \"created_at\":\"2015-12-02T18:59:07+0000\",\n \"timestamp\":1449082747,\n \"retweeted\":false,\n \"retweeted_user\":null,\n \"published\":false,\n \"media\":null\n}", "language": "json" } ] } [/block] Only verified Tweets will be published to the Twitter Streaming API which means they have either originated from a trusted source (e.g. [@WorldTriathlon](https://twitter.com/worldtriathlon) or @[TriathlonLive](https://twitter.com/triathlonlive) account) or have passed through a manual moderation process. [block:api-header] { "type": "basic", "title": "Example" } [/block] A very basic implementation of the Twitter Streaming API is available [here](https://world-triathlon.github.io/twitter-sample.html).