Skip to main content
Search for tags by name.

​
Request

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

​
Parameters

ParameterTypeDefaultDescription
qstringRequiredSearch query
limitinteger10Max 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