Tag

Represents a hashtag used within the content of a status.

Example

{ "name": "nowplaying", "url": "https://mastodon.social/tags/nowplaying", "history": [  { "day": "1574553600", "uses": "200", "accounts": "31" },  { "day": "1574467200", "uses": "272", "accounts": "39" },  { "day": "1574380800", "uses": "345", "accounts": "40" },  { "day": "1574294400", "uses": "366", "accounts": "46" },  { "day": "1574208000", "uses": "226", "accounts": "32" },  { "day": "1574121600", "uses": "217", "accounts": "42" },  { "day": "1574035200", "uses": "214", "accounts": "34" }  ], "following": false}

Attributes

`name`

Description: The value of the hashtag after the # sign.
Type: String
Version history:
0.9.0 - added

`url`

Description: A link to the hashtag on the instance.
Type: String (URL)
Version history:
0.9.0 - added

`history`

Description: Usage statistics for given days (typically the past week).
Type: Array of Hash
Version history:
2.4.1 - added

`history[][day]`

Description: UNIX timestamp on midnight of the given day.
Type: String (UNIX timestamp)
Version history:
2.4.1 - added

`history[][uses]`

Description: The counted usage of the tag within that day.
Type: String (cast from an integer)
Version history:
2.4.1 - added

`history[][accounts]`

Description: The total of accounts using the tag within that day.
Type: String (cast from an integer)
Version history:
2.4.1 - added

`following`optional

Description: Whether the current token’s authorized user is following this tag.
Type: Boolean
Version history:
4.0.0 - added

Admin::Tag attributes

{ "name": "caturday", "url": "https://mastodon.example/tags/caturday", "history": [  { "day": "1669507200", "accounts": "53", "uses": "56" },  { "day": "1669420800", "accounts": "142", "uses": "171" },  { "day": "1669334400", "accounts": "11", "uses": "11" },  { "day": "1669248000", "accounts": "8", "uses": "9" },  { "day": "1669161600", "accounts": "8", "uses": "20" },  { "day": "1669075200", "accounts": "11", "uses": "11" },  { "day": "1668988800", "accounts": "17", "uses": "22" }  ], "id": "802", "trendable": true, "usable": true, "requires_review": false}

`id`

Description: The ID of the Tag in the database.
Type: String (cast from integer, but not guaranteed to be a number)
Version history:
3.5.0 - added

`trendable`

Description: Whether the hashtag has been approved to trend.
Type: Boolean
Version history:
3.5.0 - added

`usable`

Description: Whether the hashtag has not been disabled from auto-linking.
Type: Boolean
Version history:
3.5.0 - added

`requires_review`

Description: Whether the hashtag has not been reviewed yet to approve or deny its trending.
Type: Boolean
Version history:
3.5.0 - added

Tag

Example

Attributes

name

url

history

history[][day]

history[][uses]

history[][accounts]

followingoptional