Deprecated: Research a Company or Person by URL
Deprecated: use research runs create (POST /v1/research/runs).
Authentication
Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token
Request
Official website or profile URL of the company, Product, Service, or person to research; a URL no current record owns researches a new one
Facts you already read verbatim on an external source page for an entity, each citing the page and exact text that support it. Omit taskPresetKey to default to apply-cited-findings, or send a preset from GET /v1/research/runs/presets; the run checks each quote against its page and writes only the facts it confirms. When the detail comes from an indexed news article or a page not read verbatim, send userPrompt instead.
How broadly the run researches the subject; omit it for COMPREHENSIVE
Model id the run uses; omit it to use the default model
Name of the subject at url, such as Clarity Health; the run verifies it and uses it to pick the right subject when the site names several
Research presets that focus the run, listed by GET /v1/research/runs/presets; omit them for a full run
Optional steering prompt, such as an observed update and its source URL (newsUrlOriginal or web URL) or which facts to check first
Response headers
Requests allowed per client IP in the current rate-limit window.
Requests left before the tightest applicable rate-limit bucket rejects.
Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.
Response
True when the chassis router, not a caller, picked chassis
Parallel read-only scout fan-out width N
Read-only research, cohort, and completion sub-agent model id
Run kind: ENRICHMENT for a research request a caller filed, TASK for a narrower run aVenture scheduled
Why the run failed; null unless failed
Typed terminal-failure class from the harness retry classifier (e.g. runtime_cap, escalated, provider_capacity, context_overflow); null unless failed
Follow-up admission for the exact current terminal generation; old engine terminals remain PENDING
Latest enrich-loop status as an opaque JSON string
Earliest re-claim time when waiting on retry backoff
Research allowance this run reserved when it was filed: COMPANY or PERSON; null for a run filed without one
Instant past which a warm resume is no longer guaranteed; the harness writes it with session_resume from the model’s cache window. Warm-resumable now iff failed/stopped and this is in the future. Null when there is no resume window.