Get tag histogram for filtered assets

curl --request GET \
  --url https://cloud.comfy.org/api/assets/tags/refine \
  --header 'X-API-Key: <api-key>'

{
  "tag_counts": {
    "checkpoint": 32,
    "lora": 193,
    "vae": 6
  }
}

GET

api

assets

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.

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

Success - Tag histogram returned

tag_counts

object

required

Map of tag names to their occurrence counts on matching assets

Show child attributes

Example:

{ "checkpoint": 32, "lora": 193, "vae": 6 }