---
updatedAt: 2025-06-11T20:16:02.000Z
agentTools:
projectIndex: https://developers.triathlon.org/llms.txt
---
# Live Twitter Feed
The **Live Twitter Feed** method returns an array of live tweets related to a live event. This method should be used in conjunction with the [Twitter Streaming API](https://developers.triathlon.org/docs/twitter-stream) with users obtaining an initial state via this endpoint and then receiving future updates through the Streaming API.
The Twitter stream provides live text commentary of a race via @triathlonlive as well as returning event specific hashtags e.g. #WTSEdmonton. The Live Twitter Feed returns an array of Tweet objects which may be filtered to produce the desired outcome.
Where event hashtags are being used if the **published** parameter is set to **false** this will return an unfiltered list of all Tweets matching the hashtag. If you wish to use a moderated stream then using **published=true** will restrict to either approved accounts or moderated comments.
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "triathlon-api-v1",
"version": "1"
},
"servers": [
{
"url": "https://api.triathlon.org/v1"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "apiKey",
"in": "header",
"name": "apikey",
"x-default": "2649776ef9ece4c391003b521cbfce7a"
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/live/twitter": {
"get": {
"summary": "Live Twitter Feed",
"description": "",
"operationId": "live-twitter-feed",
"parameters": [
{
"name": "per_page",
"in": "query",
"description": "How many tweets to be returned per page",
"schema": {
"type": "integer",
"format": "int32",
"default": 10
}
},
{
"name": "page",
"in": "query",
"description": "The page number to be returned",
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "published",
"in": "query",
"description": "Only display tweets that have passed moderation",
"schema": {
"type": "boolean",
"default": true
}
},
{
"name": "start_date",
"in": "query",
"description": "Only show tweets published after the start_date",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "end_date",
"in": "query",
"description": "Only show tweets published before end_date",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "exclude_retweets",
"in": "query",
"description": "Exclude retweets from the results",
"schema": {
"type": "boolean",
"default": false
}
},
{
"name": "exclude_replies",
"in": "query",
"description": "Exclude replies from the results",
"schema": {
"type": "boolean",
"default": false
}
},
{
"name": "screen_name",
"in": "query",
"description": "Restrict results to a specific Twitter screen_name",
"schema": {
"type": "string"
}
},
{
"name": "before",
"in": "query",
"description": "Only return Tweets after this id",
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "after",
"in": "query",
"description": "Only return Tweets before this id",
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "filter",
"in": "query",
"description": "Filter Tweets for a word or hashtag",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"code\":200,\n \"status\":\"success\",\n \"total\":795,\n \"per_page\":10,\n \"current_page\":1,\n \"last_page\":80,\n \"from\":1,\n \"to\":10,\n \"data\":[\n {\n \"user\":{\n \"id\":20680082,\n \"name\":\"World Triathlon\",\n \"screen_name\":\"worldtriathlon\",\n \"profile_image_url\":\"https:\\/\\/pbs.twimg.com\\/profile_images\\/378800000078714793\\/888c46aecbcd066ad99be9b5b7530224_normal.jpeg\",\n \"verified\":true,\n \"link\":\"https:\\/\\/twitter.com\\/worldtriathlon\"\n },\n \"tweet\":\"RT @usatriathlon<\\/a>: Now accepting #USATMemberCorner<\\/a> submissions for the spring issue of USA Triathlon Magazine: https:\\/\\/t.co\\/5uU6opaTON<\\/a> https\\u2026\",\n \"id\":692048139386241025,\n \"id_str\":\"692048139386241025\",\n \"source\":\"Twitter for iPhone<\\/a>\",\n \"created_at\":\"2016-01-26T18:15:08+0000\",\n \"timestamp\":1453832108,\n \"retweeted\":true,\n \"retweeted_user\":{\n \"id\":14630047,\n \"name\":\"USA Triathlon\",\n \"screen_name\":\"usatriathlon\",\n \"profile_image_url\":\"https:\\/\\/pbs.twimg.com\\/profile_images\\/612604968\\/sqaure_1_USAT10LogoWO_normal.jpg\",\n \"verified\":true,\n \"link\":\"https:\\/\\/twitter.com\\/14630047\"\n },\n \"published\":true,\n \"media\":\"https:\\/\\/pbs.twimg.com\\/media\\/CZqjnEwVAAA-fFA.jpg\"\n }\n ]\n}"
}
},
"schema": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"example": 200,
"default": 0
},
"status": {
"type": "string",
"example": "success"
},
"total": {
"type": "integer",
"example": 795,
"default": 0
},
"per_page": {
"type": "integer",
"example": 10,
"default": 0
},
"current_page": {
"type": "integer",
"example": 1,
"default": 0
},
"last_page": {
"type": "integer",
"example": 80,
"default": 0
},
"from": {
"type": "integer",
"example": 1,
"default": 0
},
"to": {
"type": "integer",
"example": 10,
"default": 0
},
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"user": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"example": 20680082,
"default": 0
},
"name": {
"type": "string",
"example": "World Triathlon"
},
"screen_name": {
"type": "string",
"example": "worldtriathlon"
},
"profile_image_url": {
"type": "string",
"example": "https://pbs.twimg.com/profile_images/378800000078714793/888c46aecbcd066ad99be9b5b7530224_normal.jpeg"
},
"verified": {
"type": "boolean",
"example": true,
"default": true
},
"link": {
"type": "string",
"example": "https://twitter.com/worldtriathlon"
}
}
},
"tweet": {
"type": "string",
"example": "RT @usatriathlon: Now accepting #USATMemberCorner submissions for the spring issue of USA Triathlon Magazine: https://t.co/5uU6opaTON https…"
},
"id": {
"type": "integer",
"example": 692048139386241000,
"default": 0
},
"id_str": {
"type": "string",
"example": "692048139386241025"
},
"source": {
"type": "string",
"example": "Twitter for iPhone"
},
"created_at": {
"type": "string",
"example": "2016-01-26T18:15:08+0000"
},
"timestamp": {
"type": "integer",
"example": 1453832108,
"default": 0
},
"retweeted": {
"type": "boolean",
"example": true,
"default": true
},
"retweeted_user": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"example": 14630047,
"default": 0
},
"name": {
"type": "string",
"example": "USA Triathlon"
},
"screen_name": {
"type": "string",
"example": "usatriathlon"
},
"profile_image_url": {
"type": "string",
"example": "https://pbs.twimg.com/profile_images/612604968/sqaure_1_USAT10LogoWO_normal.jpg"
},
"verified": {
"type": "boolean",
"example": true,
"default": true
},
"link": {
"type": "string",
"example": "https://twitter.com/14630047"
}
}
},
"published": {
"type": "boolean",
"example": true,
"default": true
},
"media": {
"type": "string",
"example": "https://pbs.twimg.com/media/CZqjnEwVAAA-fFA.jpg"
}
}
}
}
}
}
}
}
}
},
"deprecated": false
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```