Skip to main content
POST
Research the web with Airsearch
Ask a research question and receive a sourced answer, with optional output fields shaped for your application.
The limit is 300 requests per minute per workspace. A success result costs 1 credit; not_found and timeout are not charged. Credits reserved for a completed not_found or timeout result are returned.
Requested schema keys are optional and nullable. Structured numeric and boolean values are returned as strings when present, so parse them explicitly when your application requires native scalar types. A timeout can return 200 OK with status: "timeout" or 504 Gateway Timeout. Narrow the prompt before retrying. For temporary 502 or 503 errors, retry with increasing delays and a fixed retry limit; contact support if errors persist.

Next step

Use Find companies when the research target should come from structured firmographic filters, or review Rate limits before adding parallel requests.

Authorizations

Authorization
string
header
required

Use an Airscale workspace API key. Never expose the key in client-side code.

Body

application/json

Provide a non-empty prompt and, optionally, a map of requested output names to type keywords or descriptions.

prompt
string
required

A research question or instruction that remains non-empty after surrounding whitespace is trimmed.

Minimum string length: 1
Pattern: \S
schema
object

Maps arbitrary requested output names to non-empty type keywords or plain-language descriptions. Stable envelope names are reserved because dynamic requested fields must not collide with status, response, reasoning, sources, confidence_score, certainty_tag, or duration_ms.

Response

A completed research result, including successful, not-found, and soft-timeout outcomes.

status
enum<string>
required
Available options:
success,
not_found,
timeout
response
required
reasoning
string | null
required
sources
string[]
required

A public source URL, public source label such as serp_snippets, or an empty string forwarded from the upstream result.

confidence_score
number
required
Required range: 0 <= x <= 1
certainty_tag
enum<string> | null
required

Null when no certainty tag could be derived.

Available options:
low,
medium,
high,
null
duration_ms
number
required
Required range: x >= 0
{key}
string | null