> ## 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.

# Search Tags

Search for tags by name.

## Request

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://fucksornot.com/api/tags/search?q=tech&limit=10"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://fucksornot.com/api/tags/search?q=tech&limit=10'
  );
  const { tags } = await response.json();
  ```
</CodeGroup>

## Parameters

| Parameter | Type    | Default  | Description          |
| --------- | ------- | -------- | -------------------- |
| `q`       | string  | Required | Search query         |
| `limit`   | integer | 10       | Max results (max 20) |

## Response

```json theme={null}
{
  "tags": [
    {
      "id": "tag-uuid-1",
      "name": "tech",
      "slug": "tech",
      "upload_count": 120,
      "created_at": "2024-01-15T10:30:00.000Z"
    },
    {
      "id": "tag-uuid-2",
      "name": "technology",
      "slug": "technology",
      "upload_count": 45,
      "created_at": "2024-02-03T08:12:00.000Z"
    },
    {
      "id": "tag-uuid-3",
      "name": "techno",
      "slug": "techno",
      "upload_count": 8,
      "created_at": "2024-03-21T17:45:00.000Z"
    }
  ]
}
```

## Use Cases

* Autocomplete for tag input
* Tag suggestions while typing
* Finding existing tags before creating new ones

## Notes

* Search is case-insensitive
* Matches tags containing the query as a substring (not just at the start)
* No authentication required