Publishing to Marketplace

Publishing makes your asset discoverable and purchasable by the entire Spartera buyer network. This guide covers how to publish, what's required, and how to optimize your listing.

Prerequisites

Before you can publish, you need:

A validated asset — Preview execution must complete successfully. See Testing and Validation.
A connected Stripe account — Your company admin must have completed Stripe Connect onboarding before any product can be listed in the marketplace. If Stripe isn't set up, the marketplace toggle is blocked. See Connecting Stripe for Payouts for the full setup guide.
A price set — You must set a per-execution price before publishing.

Publishing Is One Toggle

Dashboard → Assets → [Your Asset] → Sell in Marketplace → ON

Or via API when creating or updating an asset:

{"sell_in_marketplace": True}

When you enable the toggle, the asset is live immediately — provided your company's Stripe account is fully verified.

Marketplace Configuration

When Sell in Marketplace is on, additional fields appear:

Price

Set your per-execution price in USD. Spartera converts this to credits for buyers automatically. You earn 80% of every execution.

pricing_api.companies_company_id_assets_asset_id_prices_post(
    company_id,
    asset_id,
    {"price_usd": 5.00}  # You earn $4.00 per execution
)

Every price change is recorded in the price history table. New prices take effect immediately for new executions.

Require Customization

When enabled, buyers must fill in the asset's parameters before purchasing and executing. This is useful when:

Your asset has required filters (region, date range, customer segment) that must be buyer-specific
You want to prevent buyers from running the asset with default/empty parameters
The asset only returns meaningful results when personalized

When Require Customization is off, buyers can execute with default parameter values.

Asset Metadata

Complete these fields to help buyers understand your data and trust your listing:

Time Period — The date range your data covers. Buyers use this to understand historical coverage and whether your data fits their needs.

Geographic Coverage — Which regions, countries, or markets this asset covers. Critical for buyers with geographic focus.

Data Refresh Frequency — How often your underlying data is updated. Be accurate here — misrepresenting freshness is the most common cause of buyer complaints.

Frequency	When to Use
Real-time	Data updates continuously or within seconds
Daily	Data refreshes once per day
Weekly	Data updates weekly
Monthly	Data refreshes on a monthly cycle

Approval Workflow for AI-Generated Assets

If your asset was created by AutoInsights (shows "AI Generated" chip), it requires admin approval before it can be published to the marketplace.

Status	What It Means
PENDING	Awaiting review — asset is not yet visible in marketplace
APPROVED	Cleared for marketplace use
NEEDS_REVISION	Admin has requested changes before approval
REJECTED	Blocked from marketplace — contact your admin

Manually created assets do not go through approval and can be published immediately.

Writing a Strong Marketplace Listing

Name

Be specific. Buyers search by keyword.

❌ Weak	✅ Strong
Customer Metric	90-Day Customer Churn Rate
Revenue Data	Monthly Recurring Revenue by Segment
Player Stats	NBA Player Efficiency Rating — Current Season

Description

Cover three things:

What does this return? — the specific output
What data powers it? — source, freshness, coverage
What decision does it enable? — the business context

Pricing Strategy

Asset Type	Suggested Price	Your Earnings (80%)
Simple aggregate	$0.50–$2.00	$0.40–$1.60
Multi-row calculation	$1.00–$5.00	$0.80–$4.00
Visualization / chart	$2.00–$8.00	$1.60–$6.40
ML model output	$5.00–$25.00	$4.00–$20.00
Regulated/proprietary data	$10.00+	$8.00+

Check the Trends product to see demand signals and pricing benchmarks for your category.

Pre-Publishing Checklist

After Publishing

Monitor Performance

Dashboard → Assets → [Your Asset] → Analytics

Key metrics:

Views — how many buyers have seen your listing
Executions — paid calls
Conversion rate — views → executions (target >5%)
Repeat buyers — buyers who executed more than once

Updating Your Asset

Non-breaking changes (performance improvements, minor query changes): patch update, same version.

Breaking changes (different output columns, renamed fields): bump major version and notify existing buyers.

curl -X PATCH https://api.spartera.com/companies/{company_id}/assets/{asset_id} \
  -H "x-api-key: your-api-key" \
  -d '{"description": "Updated with Q2 2025 data coverage"}'

Taking an Asset Down

# Unpublish (removes from marketplace, existing buyers retain access)
curl -X PATCH https://api.spartera.com/companies/{company_id}/assets/{asset_id} \
  -H "x-api-key: your-api-key" \
  -d '{"sell_in_marketplace": false}'

If you want to stop selling everything at once, prefer toggling each product off individually rather than disconnecting Stripe — see Connecting Stripe for Payouts for why.

Connecting Stripe for Payouts — Required for any seller
Testing and Validation — Validate before publishing
Credit System — How your earnings work
Revenue Sharing — The 80/20 payout model
Use Cases & Examples — How other sellers structure their assets

Publishing to Marketplace