Publish

Creating listings

A listing is the public, purchasable surface around an asset. One asset can power many listings.

The listing model

An asset is the artifact (a model, dataset, or workflow). A listing is the storefront wrapper around it: title, gallery, price, license, audience.

Splitting these lets you sell the same asset under multiple terms — for example, an MIT license for individuals and a commercial seat license for enterprises.

Create a one-time listing

python

node.listings.create(
    asset_id="mdl_01HZX9...",
    title="Lift-and-Place Manipulation Policy",
    short_description="Trained on 100k Panda episodes. 87% real-robot success rate.",
    long_description_path="./LISTING.md",
    pricing={
        "model": "one_time",      # one_time | subscription | usage
        "price_usd": 49.00,
    },
    license="MIT",
    tags=["manipulation", "panda", "rgb-d"],
    gallery=[
        "./media/demo.mp4",
        "./media/eval_plot.png",
    ],
    visibility="public",          # public | unlisted | private
)

Subscriptions

Use subscriptions for living artifacts: rolling datasets, hosted endpoints, or models with ongoing updates. Subscribers receive every revision shipped during their billing window.

python

node.listings.create(
    asset_id="ds_01HZY1...",
    title="Continuously Updated Driving Logs",
    pricing={
        "model": "subscription",
        "interval": "month",
        "price_usd": 499.00,
        "trial_days": 7,
    },
)

Usage-based pricing

For hosted inference, charge per call. Node Data meters requests at the gateway and rolls them up at the end of the billing period.

python

node.listings.create(
    asset_id="mdl_01HZW8...",
    title="Vision-Language-Action 7B",
    pricing={
        "model": "usage",
        "per_unit_usd": 0.0008,
        "unit": "inference_call",
        "included_units": 1000,
    },
)

Gallery and media

Up to 8 images or videos per listing
Recommended hero size: 1600×900
Videos auto-compressed to web-optimized H.264 and AV1
Plots and benchmarks rendered first in the marketplace card

Visibility

Mode	Discoverable in search	Requires sign-in	Use case
`public`	Yes	No	General sale
`unlisted`	No	No	Share by link
`private`	No	Yes, allowlist	Internal team, enterprise pilots

Editing a live listing

Title, description, gallery, and pricing can be edited at any time. Already-purchased customers always retain access at the price they paid.

The listing model

An asset is the artifact (a model, dataset, or workflow). A listing is the storefront wrapper around it: title, gallery, price, license, audience.

Splitting these lets you sell the same asset under multiple terms — for example, an MIT license for individuals and a commercial seat license for enterprises.

Create a one-time listing

python

node.listings.create(
    asset_id="mdl_01HZX9...",
    title="Lift-and-Place Manipulation Policy",
    short_description="Trained on 100k Panda episodes. 87% real-robot success rate.",
    long_description_path="./LISTING.md",
    pricing={
        "model": "one_time",      # one_time | subscription | usage
        "price_usd": 49.00,
    },
    license="MIT",
    tags=["manipulation", "panda", "rgb-d"],
    gallery=[
        "./media/demo.mp4",
        "./media/eval_plot.png",
    ],
    visibility="public",          # public | unlisted | private
)

Subscriptions

Use subscriptions for living artifacts: rolling datasets, hosted endpoints, or models with ongoing updates. Subscribers receive every revision shipped during their billing window.

python

node.listings.create(
    asset_id="ds_01HZY1...",
    title="Continuously Updated Driving Logs",
    pricing={
        "model": "subscription",
        "interval": "month",
        "price_usd": 499.00,
        "trial_days": 7,
    },
)

Usage-based pricing

For hosted inference, charge per call. Node Data meters requests at the gateway and rolls them up at the end of the billing period.

python

node.listings.create(
    asset_id="mdl_01HZW8...",
    title="Vision-Language-Action 7B",
    pricing={
        "model": "usage",
        "per_unit_usd": 0.0008,
        "unit": "inference_call",
        "included_units": 1000,
    },
)

Visibility

Mode

Discoverable in search

Requires sign-in

Use case

public

Yes

General sale

unlisted

Share by link

private

Yes, allowlist

Internal team, enterprise pilots

Editing a live listing

Title, description, gallery, and pricing can be edited at any time. Already-purchased customers always retain access at the price they paid.