Search Tags - FoN API Documentation

Search for tags by name.

Request

curl "https://fucksornot.com/api/tags/search?q=tech&limit=10"

const response = await fetch(
  'https://fucksornot.com/api/tags/search?q=tech&limit=10'
);
const { tags } = await response.json();

Parameters

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

Response

{
  "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