---
title: "Gamified Startup Prediction"
method: POST
path: "/api/gamified-predict"
---

# Gamified Startup Prediction

`POST /api/gamified-predict`

## Request

- Base URL: `https://api.exploreyc.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.exploreyc.com/api/gamified-predict`
- Auth: none declared

Predict startup success using gamification scoring.

Combines:
1. Idea quality based on semantic similarity to successful YC companies
2. Team profile scoring (if provided)
3. Market potential analysis
4. Achievements and challenges unlocked

Returns a gamified response with scores, tier, matched companies, and challenges.

## Request body

- GamifiedPredictionRequest
  - `idea_description` string, required
  - `industry` string, required
  - `market_type` string, nullable
  - `location` string, nullable
  - `founder_info` FounderInfo
    - `count` integer, nullable
    - `expertise` string[], nullable
    - `has_repeat_founder` boolean, nullable
    - `has_complementary_skills` boolean, nullable
  - `max_matches` integer, nullable

## Response `200`

Successful Response

- GamifiedPredictionResponse
  - `prediction_id` string, required
  - `idea_score` integer, required
  - `team_score` integer, nullable, required
  - `market_score` integer, required
  - `combined_score` integer, required
  - `percentile` integer, required
  - `tier` string, required
  - `tier_emoji` string, required
  - `similar_companies` object[], required
  - `achievements` object[], required
  - `challenges` object[], required
  - `leaderboard_position` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/exploreyc/apis/yc-company-scraper-api.md) - [All operations](https://skmtc.dev/exploreyc/apis/yc-company-scraper-api/llms.txt) - [OpenAPI document](https://skmtc.dev/exploreyc/apis/yc-company-scraper-api/revisions/d48bd3e241b8?raw)