Skip to main content
POST
/
broad-search
curl --request POST \
  --url https://api.octen.ai/broad-search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "compare cloud GPU pricing across major providers",
  "max_queries": 5
}
'
{
  "data": {
    "query": "Latest central bank interest rate decisions globally",
    "queries": [
      "central bank interest rate decisions 2026",
      "latest global central bank rate hikes",
      "recent central bank monetary policy changes",
      "major central bank interest rate announcements today",
      "ECB interest rate decision 2026"
    ],
    "search_results": [
      {
        "query": "recent central bank monetary policy changes",
        "results": [
          {
            "title": "United States Monetary Policy June 2026 - FocusEconomics",
            "url": "https://www.focus-economics.com/countries/united-states/news/monetary-policy/...",
            "highlight": "United States: Central Bank keeps rates steady in June. At its 17 June meeting, the Central Bank kept the target range for the federal funds rate at 3.50-3.75%...",
            "full_content": "United States: Central Bank keeps rates steady in June\nLatest bank decision: At its 17 June meeting, the Central Bank kept the target range for the federal funds rate at 3.50-3.75%, following 75 basis points of rate cuts from August to December last year. [...truncated...]",
            "authors": "FocusEconomics",
            "time_published": "2026-06-18T00:00:00Z",
            "time_last_crawled": "2026-06-18T14:18:27Z",
            "favicon": ""
          }
        ],
        "latency": 116
      },
      {
        "query": "ECB interest rate decision 2026",
        "results": [
          {
            "title": "Monetary policy decisions",
            "url": "https://www.ecb.europa.eu/press/pr/date/2025/html/ecb.mp251218~58b0e415a6.en.html",
            "highlight": "The Governing Council today decided to keep the three key ECB interest rates unchanged...",
            "full_content": "Monetary policy decisions\n18 December 2025\nThe Governing Council today decided to keep the three key ECB interest rates unchanged. [...truncated...]",
            "authors": "European Central Bank",
            "time_published": "2025-12-18T00:00:00Z",
            "time_last_crawled": "2026-05-20T22:27:18Z",
            "favicon": ""
          }
        ],
        "latency": 110
      }
    ]
  },
  "request_id": "20260626113629956CJ6G3AG7C2",
  "meta": {
    "usage": {
      "num_search_queries": 5,
      "full_content_tokens": 25039
    },
    "latency": 1649
  },
  "code": 0
}
{
"code": 400,
"msg": "Invalid params. query is required"
}
{
"code": 401,
"msg": "Invalid API Key"
}
{
"code": 403,
"msg": "Insufficient balance in account"
}
{
"code": 429,
"msg": "Exceeding the rate limit"
}
{
"code": 500,
"msg": "Internal error"
}

Authorizations

Authorization
string
header
required

Bearer token used for request authentication. Alternatively, you can send the API key in the x-api-key header. Note: A payment method is required to use the API.

Body

application/json
query
string
required

The original search query.

Maximum string length: 500
max_queries
integer
default:5

Upper bound on the number of sub-queries generated.

Required range: 1 <= x <= 30
search_options
object

Search options applied to each sub-query. Shares the same parameters and defaults as the Web Search API.

Response

Successful broad search response

code
integer

Business status code. 0 indicates success.

msg
string

A message describing the result.

request_id
string

The unique identifier for this request.

data
object

The main response payload.

meta
object

Additional metadata for the search request.