Skip to main content
POST
cURL

Authorizations

x-api-key
string
header
required

Your Huntr API key. Get one at tryhuntr.com. Pass as x-api-key header on all authenticated requests.

Body

application/json
prompt
string
required

The research question or task. Be specific about the context and output your workflow needs.

tier
enum<string>
default:standard

Controls which capabilities are available and the synthesis model. Check GET /pricing for current tier and model prices.

Available options:
lite,
standard,
deep
model
string

Override the synthesis model. Must match the model ID (e.g. gpt-5, claude-opus-4.7, gemini-3.1-pro). Price adjusts automatically based on model cost.

schema
object

Optional flat field map for structured output. Keys are top-level result fields and values describe what each field should contain. This is not JSON Schema and does not support nested schema definitions. Example: { summary: 'Concise account summary', recommended_angles: 'Array of practical sales angles', risks: 'Array of deal risks' }.

callback_url
string<uri>

Async mode. If provided, the API returns 202 immediately with a request_id and POSTs the full result to this URL when done. Useful for long-running deep research.

Response

Research completed synchronously.

success
boolean
required
request_id
string
required
result
object
required
price
number
required
credits_remaining
number
required