Unbuilt API

Programmatic access to real-time market gap intelligence. Get complaints, opportunity gaps, and trend data via simple REST endpoints, powered by 10,000+ signals scraped hourly.

Base URL: https://us-central1-what2buildnext.cloudfunctions.net/api/api/v1

Quick Start

Authentication Pass your API key via the x-api-key header on every request. Rate limit info is returned in X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset response headers.

# Get the full dashboard
curl -H "x-api-key: gs_live_YOUR_KEY_HERE" \
  https://us-central1-what2buildnext.cloudfunctions.net/api/api/v1/dashboard

# Filter gaps by category (Pro+)
curl -H "x-api-key: gs_live_YOUR_KEY_HERE" \
  "https://us-central1-what2buildnext.cloudfunctions.net/api/api/v1/gaps?category=Finance"
          

Pricing Tiers

Free

$0/mo

100 requests / day
/dashboard endpoint
/usage and /account endpoints
Community support

Pro

$49/mo

1,000 requests / day
All Free endpoints
/gaps with category filters
/complaints with category filters
Email support

Upgrade to Pro

Enterprise

$199/mo

10,000 requests / day
All Pro endpoints
/trends with historical snapshots
Priority support

Upgrade to Enterprise

Endpoints

POST /api/v1/signup Public

Create a free account and receive an API key. Send {"email": "you@example.com"} as JSON body.

GET /api/v1/checkout?tier=pro|enterprise Public

Redirects to Stripe Checkout for the selected tier. Optionally pass &email= and &api_key= to link to an existing account.

GET /api/v1/dashboard Free+

Returns the full dashboard: complaints, gaps, bets, feed, brief, and metadata. Cached for 5 minutes.

GET /api/v1/gaps?category=X Pro+

Returns opportunity gaps, optionally filtered by category (e.g., Finance, Health & Fitness).

GET /api/v1/complaints?category=X Pro+

Returns aggregated complaints, optionally filtered by category.

GET /api/v1/trends?days=7 Enterprise

Returns hourly dashboard snapshots for the last N days (max 30). Shows how gaps and complaints evolve over time.

GET /api/v1/usage Free+

Returns your API usage for today: request count, daily limit, remaining quota, and per-endpoint breakdown.

GET /api/v1/account Free+

Returns your account info (email, tier, status) and a Stripe billing portal link to manage your subscription.

Response Examples

GET /api/v1/dashboard

{
  "meta": {
    "signals": 10342,
    "lastScrape": "2026-02-06T12:00:00Z",
    "topGap": "Slack alternative / improvement",
    "arr": "$50M+"
  },
  "complaints": [ ... ],
  "gaps": [ ... ],
  "bets": [ ... ],
  "feed": [ ... ],
  "brief": { ... },
  "categories": ["Business", "Education", ...]
}

GET /api/v1/usage

{
  "date": "2026-02-06",
  "requestCount": 42,
  "dailyLimit": 1000,
  "remaining": 958,
  "endpointCounts": {
    "_api_v1_dashboard": 30,
    "_api_v1_gaps": 12
  }
}

Error Responses

// 401 — Missing or invalid API key
{ "error": "Missing x-api-key header" }

// 403 — Insufficient tier
{ "error": "This endpoint requires a pro plan or higher",
  "currentTier": "free",
  "upgrade": "/api/v1/checkout?tier=pro" }

// 429 — Rate limited
{ "error": "Daily rate limit exceeded",
  "limit": 100,
  "resetInSeconds": 43200 }