---
description: View hashtags that are currently being used more frequently than usual.
---

# trends

## Trending tags

<mark style="color:blue;">`GET`</mark> `https://mastodon.example/api/v1/trends`

Tags that are being used more frequently within the past week.\
\
**Returns:** Array of Tag with History\
**OAuth:** Public\
**Version history:**\
3.0.0 - added

#### Query Parameters

| Name  | Type   | Description                                          |
| ----- | ------ | ---------------------------------------------------- |
| limit | number | Maximum number of results to return. Defaults to 10. |

{% tabs %}
{% tab title="200 " %}
```javascript
[
  {
    "name": "hola",
    "url": "https://mastodon.social/tags/hola",
    "history": [
      {
        "day": "1574726400",
        "uses": "13",
        "accounts": "10"
      },
      ...
    ]
  },
  {
    "name": "SaveDotOrg",
    "url": "https://mastodon.social/tags/SaveDotOrg",
    "history": [
      {
        "day": "1574726400",
        "uses": "9",
        "accounts": "9"
      },
      ...
    ]
  },
  {
    "name": "introduction",
    "url": "https://mastodon.social/tags/introduction",
    "history": [
      {
        "day": "1574726400",
        "uses": "15",
        "accounts": "14"
      },
      ...
    ]
  },
  ...
]
```
{% endtab %}
{% endtabs %}
