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 including them; pass false to exclude.

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[]

Database column to use as ascending ordering. Add ;desc as suffix on each column for descending sort

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