UnforgeAPI Documentation

curl -X POST https://www.unforgeapi.com/api/v1/deep-research \
  -H "Authorization: Bearer uf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "iPhone 16 Pro Max",
    "mode": "extract",
    "preset": "tech",
    "extract": ["price", "release_date", "key_features", "storage_options"]
  }'

curl -X POST https://www.unforgeapi.com/api/v1/deep-research \
  -H "Authorization: Bearer uf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Compare Tesla, Rivian, and Lucid stock performance",
    "mode": "compare",
    "preset": "stocks",
    "queries": ["Tesla stock TSLA", "Rivian stock RIVN", "Lucid stock LCID"],
    "webhook": "https://your-app.com/api/research-callback"
  }'

# Returns immediately:
# { "status": "processing", "request_id": "req_abc123" }

# Your webhook receives the full report when ready

{
  "report": "## Executive Summary\n\nQuantum computing in 2026 has reached...",
  "facts": {
    "key_stats": ["IBM: 1,121 qubits", "Google: 70 logical qubits"],
    "dates": ["Q2 2026: IBM Condor launch"],
    "entities": ["IBM", "Google", "IonQ", "Rigetti"]
  },
  "sources": [
    { "title": "IBM Quantum Roadmap 2026", "url": "https://..." },
    { "title": "Nature: Quantum Computing Advances", "url": "https://..." }
  ],
  "meta": {
    "latency_ms": 28450,
    "cached": false,
    "search_results": 5,
    "preset": "tech"
  }
}

Authorization: Bearer uf_your_api_key

# Managed tier - just your API key, that's it!
curl -X POST https://www.unforgeapi.com/api/v1/chat \
  -H "Authorization: Bearer uf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"query": "What is quantum computing?"}'

// Deep Research - get a comprehensive report
const response = await fetch('https://www.unforgeapi.com/api/v1/deep-research', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer uf_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    query: 'Latest developments in quantum computing',
    preset: 'tech',
    mode: 'report'
  })
});

const data = await response.json();
console.log(data.report);
// Full research report with citations
console.log(data.sources);
// Array of source URLs

import requests

# Deep Research with data extraction
response = requests.post(
    'https://www.unforgeapi.com/api/v1/deep-research',
    headers={
        'Authorization': 'Bearer uf_your_api_key',
        'Content-Type': 'application/json'
    },
    json={
        'query': 'Bitcoin price analysis',
        'preset': 'crypto',
        'mode': 'extract',
        'extract': ['current_price', 'market_cap', '24h_change', 'volume']
    }
)

data = response.json()
print(data['extracted'])  # Structured data
print(data['sources'])    # Source citations

const response = await fetch('https://www.unforgeapi.com/api/v1/chat', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer uf_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    query: 'What is the status of my order?',
    context: 'Order #12345: Shipped on Jan 1, 2026. Expected delivery: Jan 5.'
  })
});

const data = await response.json();
console.log(data.answer);
// "Based on the order information, Order #12345 was shipped on January 1, 2026..."
console.log(data.meta.routed_to);
// "CONTEXT" - no web search needed!

import requests

response = requests.post(
    'https://www.unforgeapi.com/api/v1/chat',
    headers={
        'Authorization': 'Bearer uf_your_api_key',
        'Content-Type': 'application/json'
    },
    json={
        'query': 'What is the status of my order?',
        'context': 'Order #12345: Shipped on Jan 1, 2026. Expected delivery: Jan 5.'
    }
)

data = response.json()
print(data['answer'])
print(f"Routed to: {data['meta']['routed_to']}")

X-RateLimit-Limit: 10
X-RateLimit-Remaining: 9
X-RateLimit-Reset: 1704067200

{
  "error": "Rate limit exceeded",
  "message": "You have exceeded the rate limit. Please try again later.",
  "retry_after": 1
}