POST Research Query

Start an agentic research job

Submit Search

POSThttps://api.anakin.io/v1/agentic-search

Start an agentic research pipeline. The job runs through 4 stages (query refinement, web search, citation scraping, analysis) and may take several minutes to complete. Poll for results using GET /v1/agentic-search/{id}.

Request Body

{
  "prompt": "Comprehensive analysis of quantum computing trends"
}

Parameter	Type	Description
`prompt` required	string	Research query or question

Response

202 Accepted

{
  "job_id": "3f8aa45d-6ea3-4107-88ce-7f39ecf48a84",
  "status": "pending",
  "message": "Agentic search job queued successfully",
  "created_at": "2024-01-01T12:00:00.000Z"
}

Response Fields

Field	Type	Description
`job_id`	string	Unique identifier for the agentic search job
`status`	string	Job status (`pending`)
`message`	string	Confirmation message
`created_at`	string	ISO 8601 timestamp of job creation

Use the job_id with GET /v1/agentic-search/{id} to poll for results. Agentic searches typically take longer than standard scrapes — poll every 10 seconds.

Code Examples

curl -X POST https://api.anakin.io/v1/agentic-search \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Comprehensive analysis of quantum computing trends"
  }'

import requests

response = requests.post(
    'https://api.anakin.io/v1/agentic-search',
    headers={'X-API-Key': 'your_api_key'},
    json={
        'prompt': 'Comprehensive analysis of quantum computing trends'
    }
)

data = response.json()
print(f"Agentic search submitted: {data['job_id']}")

const response = await fetch('https://api.anakin.io/v1/agentic-search', {
  method: 'POST',
  headers: {
    'X-API-Key': 'your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    prompt: 'Comprehensive analysis of quantum computing trends'
  })
});

const data = await response.json();
console.log(data.job_id);