Skip to main content
GET
Retrieves a list of nodes

Query Parameters

page
integer
default:1

Page number of the nodes list

limit
integer
default:10

Number of nodes to return per page. Values above the declared maximum are outside the contract, but this service does not reject them: it serves the maximum instead, and the page size actually served is echoed back as limit (and drives totalPages), so a clamp is always detectable by the caller. Treat the maximum as the real page stride — a client that asks for more and assumes it received more will miss rows. 0 and negative values are also accepted and select the default, which is why no minimum is declared: sub-1 is meaningful here, not invalid.

Required range: x <= 100
supported_os
string

Filter nodes by supported operating systems

supported_accelerator
string

Filter nodes by supported accelerator

include_banned
boolean

Whether to include banned nodes in the results. Defaults to excluding them; pass true to include.

timestamp
string<date-time>

Retrieve nodes created or updated after this timestamp (ISO 8601 format)

latest
boolean

Whether to fetch fresh result from database or use cached one if false

sort
string[]

Node column to order by, ascending; add ;desc as a suffix for descending. Allowed columns: id, normalized_id, publisher_id, name, category, author, status, create_time, update_time, total_install, total_star, total_review, github_stars, search_ranking. Column and direction are case-insensitive. At most 2 sort terms are applied (a primary order and a tie-breaker); an unknown column, a malformed term, a repeated column or a term past the second is ignored rather than rejected, and the listing is returned without that ordering.

node_id
string[]

node_id to use as filter

comfyui_version
string

Comfy UI version

form_factor
string

The platform requesting the nodes

Response

A paginated list of nodes

limit
integer

Maximum number of nodes per page

nodes
object[]
page
integer

Current page number

total
integer

Total number of nodes available

totalPages
integer

Total number of pages available