Skip to main content
POST
https://app.firmware.ai
/
api
/
v1
/
research
Create deep research
curl --request POST \
  --url https://app.firmware.ai/api/v1/research \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "topic": "<string>"
}
'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued"
}
Start a deep research job — the same multi-step research experience you get from Perplexity Deep Research, OpenAI Deep Research, or Gemini Deep Research, now available via API. Give it a topic and the agent will search the web, read pages, extract insights, and follow up with deeper queries. After a few minutes you get back a comprehensive report with sources. Deep research runs asynchronously (typically 2-5 minutes). Use the returned id to poll for status and results.

​
Authenticate

Use an API key in the Authorization header. 
curl https://app.firmware.ai/api/v1/research \
  -H "Authorization: Bearer $FIRMWARE_API_KEY"

​
Request body

​
topic
string
required
The research topic or question to investigate. Be specific for better results.
"What are the latest advancements in quantum computing and their practical applications?"

​
Response

​
id
string
Unique identifier for the research job. Use this to poll for status and results.
​
status
string
Initial status of the research job. Always queued on creation.

​
Examples

curl https://app.firmware.ai/api/v1/research \
  -H "Authorization: Bearer $FIRMWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "What are the latest advancements in quantum computing?"
  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued"
}