Skip to content

Deep Research

Request

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

Security
BearerAuth
Bodyapplication/jsonrequired
querystring, <= 8000 characters(Query)required

The research question or topic to investigate deeply

optionsDeepResearchOptions (object) or null
Any of:

Options for deep research requests.

agent_typestring or null(Agent Type)
Any of:

Type of specialized agent to use for processing

string
curl -i -X POST \
  https://api-gateway.agenthq.withlantern.com/v1/enrich/research \
  -H 'Authorization: Bearer <YOUR_ApiToken_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "Research the latest developments in renewable energy storage technology",
    "options": {
      "format_json": false
    },
    "agent_type": "funding"
  }'

Responses

Successful Response

Bodyapplication/json
successboolean(Success)required

Boolean indicating request success

querystring(Query)required

Echo of the input query

responsestring or object(Response)required
Any of:

Deep research response with comprehensive analysis

string
confidencenumber or null(Confidence)
Any of:

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

[ 0 .. 1 ]
number
credits_consumedinteger(Credits Consumed)required

Number of credits used for this request

credits_remaininginteger or null(Credits Remaining)
Any of:

Approximate remaining credit balance. Use GET /v1/credits/remaining for precise balance.

integer
token_usageobject(TokenUsage)required

Token consumption details

processing_time_msinteger(Processing Time Ms)required

Time taken to process the request in milliseconds

agent_usedstring(Agent Used)required

Type of agent that was used for processing

Response
{
  "success": true,
  "query": "string",
  "response": "string",
  "confidence": 1,
  "credits_consumed": 0,
  "credits_remaining": 0,
  "token_usage": {
    "prompt_tokens": 0,
    "completion_tokens": 0,
    "total_tokens": 0
  },
  "processing_time_ms": 0,
  "agent_used": "string"
}