# List tags

**Publié le** : 2026-05-12
**Catégorie** : Storefront API

## `GET /tags`

**List tags**

List published content tags for the site. Tags are a non-hierarchical
taxonomy. Supports `locale` and `search` filters.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `page` | query | number | No | Number |
| `limit` | query | number | No | Number <= 100 |
| `search` | query | string | No | Full-text search query |
| `sortBy` | query | "created_at" \| "updated_at" \| "name" \| "slug" | No | One of: created_at, updated_at, name, slug |
| `sortOrder` | query | "asc" \| "desc" | No | One of: asc, desc |
| `dateFrom` | query | string | No | Filter from date (ISO 8601) |
| `dateTo` | query | string | No | Filter until date (ISO 8601) |
| `slug` | query | string | No | URL-friendly identifier, unique per site and locale |
| `slugs` | query | string[] | No | Array of strings |
| `ids` | query | string[] | No | Array of strings |
| `excludeIds` | query | string[] | No | Array of strings |


### Responses

| Status | Description |
| --- | --- |
| `200` | Successful response |


> **Notes:** Cache: `Cache-Control: public, max-age=300`. Rate-limit bucket: general.

### Examples

```curl
curl "https://api.lynkow.com/public/{siteId}/tags?locale=en"
```

```javascript
const res = await fetch(`https://api.lynkow.com/public/${siteId}/tags?locale=en`)
const { data, meta } = await res.json()
```

### Response Example

```json
"{\n  \"data\": [\n    { \"id\": \"01J9TVK7M3FH9X1B6Q4D8R0NPC\", \"name\": \"pricing\", \"slug\": \"pricing\", \"locale\": \"en\", \"contentCount\": 8 },\n    { \"id\": \"01J9TVMW6QHA2T9B7N5K3J1XDE\", \"name\": \"company\", \"slug\": \"company\", \"locale\": \"en\", \"contentCount\": 14 }\n  ],\n  \"meta\": { \"total\": 2, \"page\": 1, \"totalPages\": 1, \"perPage\": 20 }\n}\n"
```

---