API Reference

Base URL: https://api.stacksomecash.com

Endpoints

List Opportunities

GET /v1/opportunities

Query parameters:

category (optional): Filter by category
tag (optional): Filter by tag

Example:

curl "https://api.stacksomecash.com/v1/opportunities?tag=ai"

Response:

[
  {
    "id": "adcreative",
    "name": "AdCreative.ai",
    "category": "Ad Generation",
    "commission": "30% Lifetime",
    "commission_type": "recurring",
    "description": "AI-generated ad creatives...",
    "signup_url": "https://...",
    "avg_payout": 50.0,
    "cookie_days": 90,
    "tags": ["ai", "marketing", "ads", "saas"]
  }
]

Get Recommendation

POST /v1/recommend

Request body:

{
  "niche": "marketing",
  "user_need": "email automation",
  "budget": "medium"
}

Response:

{
  "opportunity": { ... },
  "match_score": 0.85,
  "why": "Matches your marketing niche. Recurring revenue.",
  "prompts": ["..."]
}

CLI Quick

GET /v1/cli/quick?niche=saas

Minimal response for terminal agents:

{
  "program": "AdCreative.ai",
  "commission": "30% Lifetime",
  "signup": "https://..."
}

CLI Help

GET /v1/cli/help

Bot-readable endpoint list (no auth required):

{
  "name": "Stack Some Cash API",
  "endpoints": {
    "signup": "POST /v1/auth/register {'email': '...'}",
    "recommend": "POST /v1/recommend {'niche': '...'} -H 'Authorization: Bearer <key>'",
    "list": "GET /v1/opportunities",
    "account": "GET /v1/account -H 'Authorization: Bearer <key>'"
  }
}

Account Info

GET /v1/account

Response:

{
  "email": "user@example.com",
  "api_key_prefix": "ssc_...abc123",
  "tier": "free",
  "recommendations_today": 0,
  "recommendations_limit": 1
}

Raw Docs (for LLMs)

GET /v1/docs

Returns this entire documentation as raw markdown. Useful for LLMs that want to understand the API.

API Reference

On this page