Buying Insights

This guide covers the complete buyer journey — from finding the right product to calling it in production.

The Spartera marketplace has two product types:

Assets return a single insight (a number, a string, a chart) — billed per execution
Endpoints return rowset data like a normal REST API — billed per request

The flow is similar for both, but endpoints have one extra concept: an auto-provisioned API key for external use. Both flows are covered below.

Step 1: Find the Right Product

Browse by Category

Navigate to marketplace.spartera.com and filter by category, industry, or price range. Use the Data Feeds filter to see only endpoints, or Insights to see only assets.

Search by Keyword

Use specific terms that describe the business problem, not just the data type. "customer churn" returns better results than "customer data."

Check Product Details

Before purchasing, every product listing shows:

What it returns (output value, chart, or row schema)
What data powers it and how fresh it is
Execution / response time benchmarks
Seller profile and rating
Price in credits

Step 2: Preview Before You Buy

Every marketplace product offers a free preview against sample data. Use this to:

Confirm the output format matches what your system expects
Verify the result makes sense for your use case
Test response time before committing credits

Asset previews show the computed value or chart. Endpoint previews show 3 sample rows of the response envelope.

Step 3: Purchase Credits

Credits are the currency of the Spartera marketplace. 1 credit = $0.50.

marketplace.spartera.com → Account → Buy Credits

Credits never expire. You can see the credit cost of any product before executing it.

→ See Credit System for full pricing details and bundle options.

Step 4: Execute / Fetch

For Asset Products

Click Run Insight on the product page (or use the API):

curl -X POST "https://api.spartera.com/companies/{company_id}/assets/{asset_id}/execute" \
  -H "x-api-key: your-analytics-key" \
  -H "Content-Type: application/json"

{
  "data": {
    "churn_rate_pct": 4.2
  },
  "meta": {
    "execution_time_ms": 287,
    "credits_used": 5,
    "data_freshness": "2025-04-01T02:00:00Z"
  }
}

For Endpoint Products

Click Fetch Data on the product page. The first time you do this, Spartera auto-provisions an API key scoped to your company and this specific endpoint. The key is shown once — copy it immediately.

After that, you can call the endpoint directly from your own apps:

curl "https://{seller_handle}.api.spartera.com/endpoints/v1/{endpoint_slug}?start=0&limit=100" \
  -H "x-api-key: ep_HeRGNo0qyvi64sRVAZI3I0GW77LpCYWi"

→ See Subscribing to Endpoints for the full buyer flow.
→ See Endpoint API Reference for response shape and pagination.

Integration Examples

Python — Asset Execution

import requests

def get_insight(company_id, asset_id, api_key):
    response = requests.post(
        f"https://api.spartera.com/companies/{company_id}/assets/{asset_id}/execute",
        headers={"x-api-key": api_key, "Content-Type": "application/json"}
    )
    response.raise_for_status()
    return response.json()["data"]

result = get_insight(COMPANY_ID, ASSET_ID, API_KEY)

Python — Endpoint Fetch

import requests

def fetch_endpoint(seller_handle, endpoint_slug, api_key, start=0, limit=100):
    response = requests.get(
        f"https://{seller_handle}.api.spartera.com/endpoints/v1/{endpoint_slug}",
        headers={"x-api-key": api_key},
        params={"start": start, "limit": limit}
    )
    response.raise_for_status()
    body = response.json()["data"]
    return body["response"]["data"], body["spartera"]

rows, meta = fetch_endpoint("txodds", "nfl-passing-yards-by-team", "ep_...")

JavaScript — Endpoint Fetch

const response = await fetch(
  `https://${sellerHandle}.api.spartera.com/endpoints/v1/${endpointSlug}?start=0&limit=100`,
  { headers: { "x-api-key": endpointApiKey } }
);
const { data } = await response.json();
console.log(data.response.data);

AI Agent Integration (via SparteraConnect)

If you use SparteraConnect, your AI agent can call marketplace assets and endpoints automatically via MCP — no per-product key management needed.

Tracking Your Usage

# Check credit balance and recent usage
curl "https://api.spartera.com/companies/{company_id}/credits" \
  -H "x-api-key: your-analytics-key"

{
  "data": {
    "balance_credits": 240,
    "balance_usd": 120.00,
    "executions_30d": 17,
    "endpoint_requests_30d": 412,
    "total_spent_credits_30d": 285
  }
}

Common Integration Patterns

Use Case	Pattern
BI Dashboard (Power BI, Tableau)	Endpoint pulled via Python data source script
Web/mobile app	Direct REST API call to endpoint or asset on user action
Data pipeline	Scheduled endpoint fetch, results written to your DB
AI agent	SparteraConnect MCP tool
Alerting	Cron job calling an asset, comparing result against threshold

Getting Help

If a product returns unexpected results or errors, contact the seller directly via the marketplace listing. For platform issues, reach [email protected].