Retrieves a list of nodes

Returns a paginated list of nodes across all publishers.

OpenAPI

````yaml https://api.comfy.org/openapi get /nodes/search openapi: 3.0.2 info: title: Comfy API version: '1.0' servers:

url: https://api.comfy.org security: [] tags:
description: Comfy Router's canonical, model-ID-addressed routes. name: Comfy Router
description: >- Signed-in users running Comfy-owned serverless apps with free runs and flat or per-second pricing (FE-2737). name: App Proxy paths: /nodes/search: get: tags:
Registry summary: Retrieves a list of nodes description: Returns a paginated list of nodes across all publishers. operationId: SearchNodes parameters:
description: Page number of the nodes list in: query name: page schema: default: 1 type: integer
description: >- 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. in: query name: limit schema: default: 10 maximum: 100 type: integer
description: Keyword to search the nodes in: query name: search schema: type: string
description: Keyword to search the nodes by repository URL in: query name: repository_url_search schema: type: string
description: Keyword to search the nodes by comfy node name in: query name: comfy_node_search schema: type: string
description: Filter nodes by supported operating systems examples: linux: value: 'POSIX :: Linux' macos: value: MacOS macosx: value: 'MacOS :: MacOS X' osIndependent: value: OS Independent ubuntu: value: 'POSIX :: Linux :: Ubuntu' windows: value: 'Microsoft :: Windows' windows10: value: 'Microsoft :: Windows :: Windows 10' in: query name: supported_os schema: type: string
description: Filter nodes by supported accelerator in: query name: supported_accelerator schema: type: string
description: >- Whether to include banned nodes in the results. Defaults to excluding them; pass true to include. in: query name: include_banned schema: type: boolean responses: '200': content: application/json: schema: properties: limit: description: Maximum number of nodes per page type: integer nodes: items: $ref: '#/components/schemas/Node' type: array page: description: Current page number type: integer total: description: Total number of nodes available type: integer totalPages: description: Total number of pages available type: integer type: object description: A paginated list of nodes '400': description: Invalid input, object invalid '404': description: Not found '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Internal server error components: schemas: Node: properties: author: type: string banner_url: description: URL to the node's banner. type: string category: deprecated: true description: >- DEPRECATED: The category of the node. Use 'tags' field instead. This field will be removed in a future version. type: string created_at: description: The date and time when the node was created format: date-time type: string description: type: string downloads: description: The number of downloads of the node. type: integer github_stars: description: Number of stars on the GitHub repository. type: integer icon: description: URL to the node's icon. type: string id: description: The unique identifier of the node. type: string latest_version: $ref: '#/components/schemas/NodeVersion' license: description: The path to the LICENSE file in the node's repository. type: string name: description: The display name of the node. type: string preempted_comfy_node_names: description: A list of Comfy node names that are preempted by this node. items: type: string type: array publisher: $ref: '#/components/schemas/Publisher' rating: description: The average rating of the node. type: number repository: description: URL to the node's repository. type: string search_ranking: description: >- A numerical value representing the node's search ranking, used for sorting search results. type: integer status: $ref: '#/components/schemas/NodeStatus' status_detail: description: The status detail of the node. type: string supported_accelerators: description: >- List of accelerators (e.g. CUDA, DirectML, ROCm) that this node supports items: type: string type: array supported_comfyui_frontend_version: description: Supported versions of ComfyUI frontend type: string supported_comfyui_version: description: Supported versions of ComfyUI type: string supported_os: description: List of operating systems that this node supports items: type: string type: array tags: items: type: string type: array tags_admin: description: Admin-only tags for security warnings and admin metadata items: type: string type: array translations: additionalProperties: additionalProperties: true type: object description: Translations of node metadata in different languages. type: object type: object ErrorResponse: properties: error: type: string message: type: string required:
error
message type: object NodeVersion: properties: changelog: description: Summary of changes made in this version type: string comfy_node_extract_status: description: The status of comfy node extraction process. type: string createdAt: description: The date and time the version was created. format: date-time type: string dependencies: description: A list of pip dependencies required by the node. items: type: string type: array deprecated: description: Indicates if this version is deprecated. type: boolean downloadUrl: description: '[Output Only] URL to download this version of the node' type: string id: type: string node_id: description: The unique identifier of the node. type: string status: $ref: '#/components/schemas/NodeVersionStatus' status_reason: type: string supported_accelerators: description: >- List of accelerators (e.g. CUDA, DirectML, ROCm) that this node supports items: type: string type: array supported_comfyui_frontend_version: description: Supported versions of ComfyUI frontend type: string supported_comfyui_version: description: Supported versions of ComfyUI type: string supported_os: description: List of operating systems that this node supports items: type: string type: array tags: items: type: string type: array tags_admin: description: >- Admin-only tags for security warnings and admin metadata. Read-only for publishers - omitted from all public responses and ignored if sent on publish; only returned on admin-authenticated responses. items: type: string type: array version: description: >- The version identifier, following semantic versioning. Must be unique for the node. type: string type: object Publisher: properties: createdAt: description: The date and time the publisher was created. format: date-time type: string description: type: string id: description: >- The unique identifier for the publisher. It's akin to a username. Should be lowercase. type: string logo: description: URL to the publisher's logo. type: string members: description: A list of members in the publisher. items: $ref: '#/components/schemas/PublisherMember' type: array name: type: string source_code_repo: type: string status: $ref: '#/components/schemas/PublisherStatus' support: type: string website: type: string type: object NodeStatus: enum:
NodeStatusActive
NodeStatusDeleted
NodeStatusBanned type: string NodeVersionStatus: enum:
NodeVersionStatusActive
NodeVersionStatusDeleted
NodeVersionStatusBanned
NodeVersionStatusPending
NodeVersionStatusFlagged type: string PublisherMember: properties: id: description: The unique identifier for the publisher member. type: string role: description: The role of the user in the publisher. type: string user: $ref: '#/components/schemas/PublisherUser' type: object PublisherStatus: enum:
PublisherStatusActive
PublisherStatusBanned type: string PublisherUser: properties: email: description: The email address for this user. type: string id: description: The unique id for this user. type: string name: description: The name for this user. type: string type: object

````