Enrich Many Companies and People
Queues one enrichment run per listed entity and person, in order, each owned by the authenticated principal and billed exactly as the single-record enrich call is. A repeated id is filed once. Returns one outcome per distinct record: its run, or a refusal (NOT_FOUND, ALLOWANCE_EXHAUSTED, AMBIGUOUS, SUBSCRIPTION_REQUIRED) for a record that cannot be filed; other records still file, and runs already filed stay queued. A record already being researched, or researched within the last 24 hours, files nothing while the other records still file; the request then answers 429 whose filedRunId lists the runs it filed. A caller without a research subscription gets 402 before any run is filed. A transient failure fails the request; retrying it reuses runs still in progress without charging them again. A list longer than the configured batch limit is refused before any run is filed. Check each run’s progress with GET /v1/research-runs/{runId} (CLI: research-runs get).
Authentication
Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token
Request
COMPREHENSIVE (the default) researches each whole profile; INDIVIDUAL runs only the tasks named in taskPresetKey
Model id for each run’s lead agent; omit to use aVenture’s default model
Task preset keys that scope or emphasize every run; at least one is required when mode is INDIVIDUAL, and an unknown key is a 400
Plain-language instruction for every run, such as which facts or sources 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
Why no run was filed; absent when run is set
The queued or reused run; absent when refusal is set