Skip to main content
POST
Start an analysis

Authorizations

x-preuve-key
string
header
required

Your API key (prv_...), sent as-is. It is the only credential the API needs - see the Authentication guide.

Body

application/json
clientRunId
string
required

Caller-chosen idempotency id. Reusing it replays the existing run.

scanType
enum<string>
required

"starter" costs nothing; "deep" runs the full paid analysis and consumes account quota. "free" is accepted as a legacy alias of "starter".

Available options:
starter,
deep
idea
string
required

The startup idea, in plain language.

targetMarket
string
targetCountry
string

ISO country code, e.g. "US" or "FR".

title
string
stage
string

Where the founder is today. Canonical values: idea, validation, mvp, launched, growth, scaling (free text tolerated). Optional here, but the MCP tools require it for deep scans; it feeds the feasibility analysis.

budget
string

Budget available to pursue the idea. Canonical values: bootstrap (no outside money), 10k, 50k, 100k, 100kPlus (over $100k), 1mPlus (over $1M); free text tolerated. Optional here, but the MCP tools require it for deep scans; it feeds the feasibility analysis.

language
string
default:en
enrichmentMode
enum<string>
default:core

"core" also generates the export-required sections; "none" returns the raw completion only.

Available options:
core,
none
publish
boolean

When true, creates a public share URL for the report.

Response

Run created (or replayed via clientRunId).

id
string<uuid>
reportId
string<uuid>
clientRunId
string
scanType
enum<string>

Your request type. Reliable from creation, even while PROCESSING.

Available options:
starter,
deep
reportType
enum<string>
Available options:
quick,
deep_dive
analysisTier
enum<string>

Derived from the report. Deep runs read "basic" until deep sections land.

Available options:
basic,
advanced
status
enum<string>
Available options:
PENDING,
PROCESSING,
COMPLETED,
FAILED
readyForExport
boolean
enrichment
object
modules
object | null

Per-module statuses. Deep reports only; null on free runs.

reportUrl
string<uri>
shareUrl
string<uri> | null