Distribution & APIs

How can I distribute my analytics?

You can publish products in three ways: privately (internal users),
semi-privately (select clients/teams), or publicly (marketplace
buyers). Choose the distribution method that best fits your use case
and security requirements.

How do exposed APIs work?

Every analytics asset can be exposed as a secure, versioned API
endpoint. Every Spartera Endpoint is itself a REST API for rowset
data. You can integrate either with your products, websites, or BI
tools using API connectors, enabling seamless embedding and access.

How do I control who can access my products?

Use advanced access controls for granular permissions. Set
user-level, team-level, or public access based on your needs. You
can manage permissions and revoke access as required.

For endpoints specifically, choose an access method:

OPEN — anyone can call (no auth)
API_KEY — requires a valid endpoint key (default, recommended)
IP — only allowed from whitelisted IPs

How do I list products in the marketplace?

Configure your assets or endpoints for public marketplace
distribution through the platform settings. Ensure proper
documentation and quality standards are met before making
products available for purchase.

How do I price my products?

You have complete control over pricing. Set prices based on
value, complexity, and market positioning. Assets are billed
per execution; endpoints are billed per successful request.

What are the two types of API keys?

Spartera has two key types:

Analytics keys (sk_spartera_...) — full-access keys for
sellers. Used for managing endpoints/assets, running analytics,
and all administrative actions.
Endpoint keys (ep_...) — scoped, single-purpose keys tied
to one endpoint. Used by buyers to fetch data from that endpoint.

See API Keys for the full reference,
including how each key type gets created and where to use it.

Can buyers use endpoint keys outside the marketplace?

Yes. Endpoint keys are designed for both inside-marketplace use
(via the Fetch Data button) and outside use (in the buyer's own
apps, agents, scripts, notebooks, etc.). The buyer copies the
plain text key value once at creation and can use it anywhere.

What if a buyer loses their endpoint key?

API key plain text values are only shown once at creation and
are not recoverable — Spartera stores only an HMAC of the key
for validation. If a buyer loses their key, they should contact
[email protected]. We can
revoke the lost key, and the next time they visit the endpoint's
product page, a new key will be auto-provisioned.

How do rate limits work for endpoints?

Sellers can configure per-buyer rate limits on their endpoints
(by IP, user, company, API key, or globally). When a buyer
exceeds the limit, they receive a 429 response with retry-after
information. Buyers are never billed for rate-limited requests.

How does pagination work for endpoints?

Endpoint requests use start and limit query parameters.
Each response includes has_more and next_start cursors
for fetching subsequent pages. Each page is billed as a
separate request. See
Endpoint API Reference for
details and code examples.