Skip to main content
POST
Generate startup ideas

Authorizations

Authorization
string
header
required

Your API key (prv_...), sent as Authorization: Bearer prv_.... It is the only credential the API needs - see the Authentication guide. The older x-preuve-key header still works for existing integrations.

Body

application/json
interests
string
required

Interests or skills to generate ideas from.

Required string length: 3 - 500
budget
string
Maximum string length: 100
audience
string
Maximum string length: 100
industry
string
Maximum string length: 100
language
string
Maximum string length: 10
pro
boolean | null

true runs the Pro model for 10 credits. Omitted, null or false runs the standard model. true on an account holding under 10 credits is refused (402 or 403), never downgraded.

fit
boolean

Founder-profile tailoring is automatic on paid plans with a saved profile; pass false to opt out. Passing true is never needed.

Response

Generated ideas. remaining and limit are null for paid-or-credited accounts, whose daily ceiling is not counted down here; free accounts see the rolling-24h window state. Pain points are teased as locked on non-paid plans.

ideas
object[]
Maximum array length: 5
remaining
integer | null
limit
integer | null
pro
boolean

Whether the Pro model answered.

fit
boolean
fitReason
enum<string>
Available options:
applied,
disabled,
requires_paid_plan,
no_profile
fitHint
string

Present when tailoring did not apply for a reason worth relaying to the user (no_profile, requires_paid_plan).