`GET /api/marketplace/items` — browse marketplace items with optional filters. Any approved user can browse.
const url = 'https://example.com/api/marketplace/items';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://example.com/api/marketplace/itemsParameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Sort order: “popular” (default), “rating”, or “newest”.
Responses
Section titled “Responses”A catalog item — an app, script, bundle, or runner offer listing.
Scoped to a source via source_id. The (source_id, slug) pair is unique.
object
ADR 0030 W6 — build framework of the item’s latest non-withdrawn
version (plain | react | svelte). Populated by list_items /
get_item via a correlated subquery; absent in queries that do not
project it (e.g. upsert_item RETURNING), where #[sqlx(default)]
supplies "plain". Surfaces a framework badge on browse cards.
Runtime String; the spec narrows it to the closed [MarketplaceFramework].
#358 — public install popularity: the number of DISTINCT workspaces that
have installed this item (marketplace_installs). Populated by
list_items / get_item via a correlated subquery mirroring rating;
absent (None) in projections that do not select it, where
#[sqlx(default)] supplies None.
ADR 0034 P4c — active price of the item’s latest version as a JSON
object {model, amount_minor, currency}, or null when the listing is
free. Populated by list_items / get_item via a correlated subquery;
absent (None) in projections that do not select it (e.g. upsert
RETURNING), where #[sqlx(default)] supplies None.
Runtime stays serde_json::Value; the spec types it as [MarketplaceItemPrice].
object
Publisher metadata bag. Runtime stays serde_json::Value; the spec types it
as Option<MarketplaceItemPublisher> (the FE reads publisher?.name) — a
seed/curated listing can carry a publisher-less (null) bag, so the optional
spec is the honest shape and the FE drops its .extend() defensive widening.
object
ADR 0034 #351 — aggregate CUSTOMER rating of this item as a JSON object
{avg, count} (avg rounded to 2 dp), or null when it has no ratings.
Populated by list_items / get_item via a correlated subquery; absent
(None) in projections that do not select it, where #[sqlx(default)]
supplies None. Distinct from verified (the moderation gate).
Runtime stays serde_json::Value; the spec types it as [MarketplaceItemRatingSummary].
object
Example
[ { "framework": "plain" }]