documentation/content/en/entities/Tag.md

---

title: Tag description: Represents a hashtag used within the content of a status. menu: docs:

parent: entities

aliases: [ "/entities/tag", "/entities/Tag", "/api/entities/tag", "/api/entities/Tag",

]

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 {#name}

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

url {#url}

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

history {#history}

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

history[][day] {#history-day}

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

history[][uses] {#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] {#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%}} {#following}

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

Admin::Tag attributes {#admin}

{
  "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 {#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 {#trendable}

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

usable {#usable}

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

requires_review {#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

{{< page-relref ref="entities/Search#tags" caption="Search (tags attribute)" >}}

{{< page-relref ref="methods/tags" caption="tags API methods" >}}

{{< page-relref ref="methods/featured_tags#suggestions" caption="GET /api/v1/featured_tags/suggestions" >}}

{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/serializers/rest/tag_serializer.rb" caption="app/serializers/rest/tag_serializer.rb" >}}

{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/serializers/rest/admin/tag_serializer.rb" caption="app/serializers/rest/admin/tag_serializer.rb" >}}

{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/models/tag.rb" caption="app/models/tag.rb" >}}

{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/models/trends/history.rb" caption="app/models/trends/history.rb" >}}