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
See also
tags
attribute)
Search (
tags API methods
GET /api/v1/featured_tags/suggestions
app/serializers/rest/tag_serializer.rb
app/serializers/rest/admin/tag_serializer.rb
app/models/tag.rb app/models/trends/history.rbLast updated December 14, 2022 路 Improve this page