# Get Popular Tags

`GET`

### Overview

Retrieve trending tags.

### Authentication

No authentication required.

### Request

* Method: `GET`
* Path: `/api/tags/popular`

#### Query parameters

| Parameter | Type    | Required | Default | Description              |
| --------- | ------- | -------- | ------- | ------------------------ |
| limit     | integer | No       | 10      | Number of tags to return |

### Response `200 OK`

```json
[
  {
    "n": "Bitcoin",
    "r": 1
  }
]
```

| Field | Type    | Description     |
| ----- | ------- | --------------- |
| n     | string  | Tag name        |
| r     | integer | Popularity rank |

### Error variants

Common public endpoint errors:

| Code | Description                         |
| ---- | ----------------------------------- |
| 400  | Bad Request — Invalid parameters    |
| 404  | Not Found — Resource does not exist |
| 500  | Internal Server Error               |

**Error response**

```json
{
  "status": 400,
  "error": "Bad Request",
  "message": "Invalid parameters"
}
```

### Python example

{% code title="get\_popular\_tags.py" %}

```python
import requests

response = requests.get(
    "https://event-service.outpoll.com/api/tags/popular",
    params={"limit": 10},
    timeout=10,
)
response.raise_for_status()

for tag in response.json():
    print(f"#{tag['r']} {tag['n']}")
```

{% endcode %}