# Deep Research

Conducts comprehensive research using advanced language models with real-time search capabilities.

Endpoint: POST /v1/enrich/research
Version: 1.4.1
Security: BearerAuth

## Request fields (application/json):

  - `query` (string, required)
    The research question or topic to investigate deeply

  - `options` (any)
    Additional options for the deep research

  - `agent_type` (any)
    Type of specialized agent to use for processing

## Response 200 fields (application/json):

  - `success` (boolean, required)
    Boolean indicating request success

  - `query` (string, required)
    Echo of the input query

  - `response` (any, required)
    Deep research response with comprehensive analysis

  - `confidence` (any)
    AI confidence score (0.0-1.0) or null if disabled

  - `credits_consumed` (integer, required)
    Number of credits used for this request

  - `credits_remaining` (integer, required)
    Credits remaining in your account after this request

  - `token_usage` (object, required)
    Token consumption details

  - `token_usage.prompt_tokens` (integer, required)
    Tokens used in the input

  - `token_usage.completion_tokens` (integer, required)
    Tokens used in the response

  - `token_usage.total_tokens` (integer, required)
    Total tokens consumed

  - `processing_time_ms` (integer, required)
    Time taken to process the request in milliseconds

  - `agent_used` (string, required)
    Type of agent that was used for processing

## Response 400 fields (application/json):

  - `success` (boolean)
    Always false for error responses

  - `error` (string, required)
    Error message

  - `details` (any)
    Additional error details

  - `request_id` (any)
    Request ID for tracking

  - `credits_required` (any)
    Credits required for insufficient credit errors

  - `credits_remaining` (any)
    Credits remaining for insufficient credit errors

  - `retry_after` (any)
    Seconds to wait before retrying for rate limit errors

## Response 401 fields (application/json):

  - `success` (boolean)
    Always false for error responses

  - `error` (string, required)
    Error message

  - `details` (any)
    Additional error details

  - `request_id` (any)
    Request ID for tracking

  - `credits_required` (any)
    Credits required for insufficient credit errors

  - `credits_remaining` (any)
    Credits remaining for insufficient credit errors

  - `retry_after` (any)
    Seconds to wait before retrying for rate limit errors

## Response 402 fields (application/json):

  - `success` (boolean)
    Always false for error responses

  - `error` (string, required)
    Error message

  - `details` (any)
    Additional error details

  - `request_id` (any)
    Request ID for tracking

  - `credits_required` (any)
    Credits required for insufficient credit errors

  - `credits_remaining` (any)
    Credits remaining for insufficient credit errors

  - `retry_after` (any)
    Seconds to wait before retrying for rate limit errors

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)

## Response 429 fields (application/json):

  - `success` (boolean)
    Always false for error responses

  - `error` (string, required)
    Error message

  - `details` (any)
    Additional error details

  - `request_id` (any)
    Request ID for tracking

  - `credits_required` (any)
    Credits required for insufficient credit errors

  - `credits_remaining` (any)
    Credits remaining for insufficient credit errors

  - `retry_after` (any)
    Seconds to wait before retrying for rate limit errors

## Response 500 fields (application/json):

  - `success` (boolean)
    Always false for error responses

  - `error` (string, required)
    Error message

  - `details` (any)
    Additional error details

  - `request_id` (any)
    Request ID for tracking

  - `credits_required` (any)
    Credits required for insufficient credit errors

  - `credits_remaining` (any)
    Credits remaining for insufficient credit errors

  - `retry_after` (any)
    Seconds to wait before retrying for rate limit errors