Skip to main content
GET
Get a pitch

Authorizations

Authorization
string
header
required

Key from Profile. Send Authorization: Bearer yb_....

Path Parameters

id
string
required

Pitch id from the list (pitch_id).

Minimum string length: 1

Query Parameters

x-vercel-protection-bypass
string

Optional. Vercel Protection Bypass for Automation — use when calling the Staging server.

Response

Pitch detail

pitch_id
string
required
pitch_date
string | null
required
added_on
string | null
required
is_premium_pitch
boolean
required

True when the author charges for this write-up.

is_locked
boolean
required

True when the write-up is paywalled and the key owner cannot read it. Title, summary, and other write-up fields are withheld.

pitch_title
string | null
required
one_liner_text
string | null
required

One-line thesis, if extracted.

pitch_summary
string | null
required
pitch_full_text
string | null
required

Full write-up. Null when is_locked is true.

source_url
string | null
required

Original post URL. May be withheld when locked.

archive
object | null
required

Archive availability. Null when the pitch is locked.

extracted_data
object | null
required

Structured fields extracted from the write-up.

investor_returns
object
required
author
object
required
company
object
required
industry_description
string | null
required
fundamentals
object
required
analytics
object
required
tags
string[]
required

Tag slugs on this pitch.

thesis
object
required