What signed-in PitchSpark users decided about a startup pitch: anonymised pass reasons, ratings and engagement
pitchspark_get_decision_summary_v1Summarise how signed-in PitchSpark users (not only investors) responded to one pitch: positive (likes and superlikes) vs passes (the thumbs block, currently withheld pending review: reason hidden_pending_review), the rating distribution and average (out of 10, to the nearest 0.5), the top pass reasons and "why we passed" themes (the team-related reasons and the team theme are withheld pending review and never listed; shares are over the listed reasons), time spent, and which pitch sections and score dimensions users read. Use when: an investor (or a founder's assistant) wants the crowd signal behind a pitch before deciding. Prefer it over pitchspark_get_pitch_v2 when only decision data is needed. Do not use for: who passed or liked (never returned), investor comments (never returned), the AI score (pitchspark_get_score_v1). Decision data from signed-in PitchSpark users needs a PitchSpark API key from an investor account (self-declared; PitchSpark does not verify accreditation): without one every decision block is available false with reason key_required. It is anonymised: counts of distinct people only, as bands ("5-9", "10-24", "25-49", "50+"), never who; shares and rates to the nearest 0.05; the pitch's founders, team and PitchSpark staff are never counted; guest and anonymous viewers are never counted; every block is withheld (reason below_min_k) when fewer than 5 distinct people are behind it, and a split (positive vs pass, rating bands) is withheld when any part of it would be under 5; no investor comment text is ever returned. Who is counted: ratings, reading time, sections and score views count ANY signed-in non-owner user (the writers check no account type), and likes, passes and pass reasons count signed-in users who swiped or gave pass feedback (also not restricted to investor accounts); only the caller of this tool must hold an investor key. Some fields are withheld pending a review (reason hidden_pending_review, or absent from a list): the team-related pass reasons and the pass rate (the likes-vs-passes thumbs block, the search card signal, investors_considered and the card-dwell figures). Treat a withheld field as no signal. Sources: signed-in users' swipe decisions (likes, passes, pass reasons, card dwell), structured pass feedback (never comment text), ratings, time on the pitch page and per-section dwell, and score-dimension views. A block with no source data is available false, reason no_data. Returns {"pitch_id","company_name","decisions":{min_k, investors_considered, truncated, thumbs, rating, pass_reasons, pass_themes, time_spent, sections, score_dimension_interest},"attribution"}. Without an investor API key the call still answers (and counts against the allowance like pitchspark_get_pitch_v1), but every block is withheld. Each pitch this tool returns counts 1 against the daily pitch allowance (the same allowance as pitchspark_search_pitches_v1), or 0 when the same API key (without a key, the same connection) already got that pitch today. Calls are logged, and each pitch returned is counted as a view.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "pitchspark_get_decision_summary_v1"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The pitch id from a search result ("id"). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present only when the call failed (isError true). | |
| pitch_id | No | ||
| decisions | No | Anonymised decision aggregates by signed-in PitchSpark users (not only investors); readable with investor API keys only (every block reason key_required otherwise). Counts are bands ("5-9", "10-24", "25-49", "50+"); every block is withheld below min_k distinct signed-in users (the counts cover any signed-in non-owner user, not only investor accounts). | |
| attribution | No | ||
| company_name | No |