Skip to main content
GET
Get tag histogram for filtered assets

Authorizations

X-API-Key
string
header
required

API key authentication. Generate an API key from your account settings at https://platform.comfy.org/profile/api-keys. Pass the key in the X-API-Key header.

Query Parameters

include_tags
string[]

Filter assets that have ALL of these tags

exclude_tags
string[]

Exclude assets that have ANY of these tags

name_contains
string

Filter assets where name contains this substring (case-insensitive)

metadata_filter
string

JSON object for filtering by metadata fields

limit
integer
default:100

Maximum number of tags to return (1-1000, default 100)

Required range: 1 <= x <= 1000
include_public
boolean
default:true

Whether to include public/shared assets in results

Response

Success - Tag histogram returned

tag_counts
object
required

Map of tag names to their occurrence counts on matching assets

Example: