curl --request POST \
--url https://api.octen.ai/search-premier \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "What record did Kendrick Lamar break at the 2026 Grammy Awards?",
"count": 5
}
'
{
"code": 0,
"msg": "success",
"request_id": "req_abc123def456",
"data": {
"query": "latest WHO guidance on influenza vaccination",
"results": [
{
"title": "Influenza (Seasonal) - World Health Organization (WHO)",
"url": "https://www.who.int/news-room/fact-sheets/detail/influenza-(seasonal)",
"highlight": "WHO recommends annual vaccination for high-risk groups\n\n...\n\nSeasonal influenza vaccination policies vary by region...",
"authors": "World Health Organization",
"time_published": "2024-10-15T00:00:00Z",
"time_last_crawled": "2026-01-20T02:12:34Z",
"favicon": "https://www.who.int/favicon.ico",
"cover_image": {
"url": "https://www.who.int/images/default-source/influenza/seasonal-influenza-cover.jpg",
"description": "Seasonal influenza vaccination"
},
"images": [
{
"url": "https://www.who.int/images/default-source/influenza/influenza-vaccine-vial.jpg",
"description": "A vial of seasonal influenza vaccine."
}
]
}
]
},
"meta": {
"usage": {
"num_search_queries": 1,
"full_content_extra_count": 0
},
"result_type": "standard",
"latency": 237,
"warning": ""
}
}{
"code": 400,
"msg": "Missing parameter query",
"request_id": "req_abc123def456"
}{
"code": 401,
"msg": "Invalid API Key",
"request_id": "req_abc123def456"
}{
"code": 403,
"msg": "Insufficient balance in account",
"request_id": "req_abc123def456"
}{
"code": 429,
"msg": "Exceeding the rate limit",
"request_id": "req_abc123def456"
}{
"code": 500,
"msg": "Internal error",
"request_id": "req_abc123def456"
}Octen Premier
Web Search Premier API Reference
Searches the live web with deeper retrieval and reranking, and returns ranked results with model-ready highlights and optional full content. Optional filters narrow sources, time windows, and languages.
POST
/
search-premier
curl --request POST \
--url https://api.octen.ai/search-premier \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "What record did Kendrick Lamar break at the 2026 Grammy Awards?",
"count": 5
}
'
{
"code": 0,
"msg": "success",
"request_id": "req_abc123def456",
"data": {
"query": "latest WHO guidance on influenza vaccination",
"results": [
{
"title": "Influenza (Seasonal) - World Health Organization (WHO)",
"url": "https://www.who.int/news-room/fact-sheets/detail/influenza-(seasonal)",
"highlight": "WHO recommends annual vaccination for high-risk groups\n\n...\n\nSeasonal influenza vaccination policies vary by region...",
"authors": "World Health Organization",
"time_published": "2024-10-15T00:00:00Z",
"time_last_crawled": "2026-01-20T02:12:34Z",
"favicon": "https://www.who.int/favicon.ico",
"cover_image": {
"url": "https://www.who.int/images/default-source/influenza/seasonal-influenza-cover.jpg",
"description": "Seasonal influenza vaccination"
},
"images": [
{
"url": "https://www.who.int/images/default-source/influenza/influenza-vaccine-vial.jpg",
"description": "A vial of seasonal influenza vaccine."
}
]
}
]
},
"meta": {
"usage": {
"num_search_queries": 1,
"full_content_extra_count": 0
},
"result_type": "standard",
"latency": 237,
"warning": ""
}
}{
"code": 400,
"msg": "Missing parameter query",
"request_id": "req_abc123def456"
}{
"code": 401,
"msg": "Invalid API Key",
"request_id": "req_abc123def456"
}{
"code": 403,
"msg": "Insufficient balance in account",
"request_id": "req_abc123def456"
}{
"code": 429,
"msg": "Exceeding the rate limit",
"request_id": "req_abc123def456"
}{
"code": 500,
"msg": "Internal error",
"request_id": "req_abc123def456"
}Authorizations
bearerAuthapiKeyAuth
Body
application/json
The search query.
Operators
site:<domain>: restrict results to a single domain. For multiple domains, useinclude_domainsandexclude_domains.-site:<domain>: exclude a single domain from the results.before:<YYYY-MM-DD>: return only pages published before this date.after:<YYYY-MM-DD>: return only pages published after this date."<words>": return only pages that contain every word inside the quotes.<term> OR <term>: return pages that match either term.
Maximum string length:
500A list of domains to specifically exclude from the search results. The -site: query operator adds to this list. If a domain appears in both include_domains and exclude_domains, exclude_domains takes precedence.
Maximum array length:
1200Maximum string length:
60Example:
["spam.com", "ads.example.net"]
Response
Successful search response
Was this page helpful?