> For the complete documentation index, see [llms.txt](https://mastodon.gitbook.io/mastodon/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mastodon.gitbook.io/mastodon/entities/tag.md).

# Tag

## Example

```javascript
{
  "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"
    }
  ]
}
```

## Base attributes

### `name`

**Description:** The value of the hashtag after the # sign.\
**Type:** String\
**Version history:** Added in 0.9.0

### `url`

**Description:** A link to the hashtag on the instance.\
**Type:** String (URL)\
**Version history:** Added in 0.9.0

## Optional attributes

### `history`

**Description:** Usage statistics for given days.\
**Type:** Array of [History](/mastodon/entities/history.md)\
**Version history:** Added in 2.4.1

## See also

* [Status#tags](/mastodon/entities/status.md#tags)
* [GET /api/v1/featured\_tags/suggestions](/mastodon/methods/accounts/featured_tags.md#suggested-tags-to-feature)

{% content-ref url="/pages/-Lr2Dehn4lq2gVBLRTnt" %}
[Status](/mastodon/entities/status.md)
{% endcontent-ref %}

{% content-ref url="/pages/-LqIfFJ\_AYYvUMnepR0N" %}
[search](/mastodon/methods/search.md)
{% endcontent-ref %}

{% embed url="<https://github.com/tootsuite/mastodon/blob/master/app/serializers/rest/tag_serializer.rb>" %}
app/serializers/rest/tag\_serializer.rb
{% endembed %}