> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fucksornot.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Tags

Get all tags with upload counts.

## Request

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://fucksornot.com/api/tags?page=1&limit=10" \
    -H "Cookie: auth-token=YOUR_JWT_TOKEN"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://fucksornot.com/api/tags?page=1&limit=10', {
    credentials: 'include'
  });
  ```
</CodeGroup>

## Parameters

| Parameter | Type    | Default | Description              |
| --------- | ------- | ------- | ------------------------ |
| `page`    | integer | 1       | Page number              |
| `limit`   | integer | 10      | Items per page (max 100) |

## Response

```json theme={null}
{
  "tags": [
    {
      "id": "tag-uuid-1",
      "name": "gadget",
      "slug": "gadget",
      "upload_count": 150
    },
    {
      "id": "tag-uuid-2",
      "name": "tech",
      "slug": "tech",
      "upload_count": 120
    }
  ],
  "page": 1,
  "limit": 10
}
```

## Tag Fields

| Field          | Type    | Description                     |
| -------------- | ------- | ------------------------------- |
| `id`           | UUID    | Tag identifier                  |
| `name`         | string  | Display name                    |
| `slug`         | string  | URL-friendly version            |
| `upload_count` | integer | Number of uploads with this tag |

## Use Cases

* Display tag cloud
* Show popular tags
* Build tag navigation