Skip to main content
POST

Authorizations

​
Authorization
string
header
default:YOUR_KANARIE_API_KEY
required

Preferred Kanarie API key authentication using Authorization: Bearer .

Body

application/json
​
search_mode
enum<string>
default:auto

Search strategy. Use recent for chronological filtering, semantic for similarity search, or auto to let Kanarie choose.

Available options:
recent,
semantic,
auto
​
query
string

Semantic query string. Required when search_mode is semantic and recommended when search_mode is auto.

​
content_types
enum<string>[]

Content surfaces to search.

Type of content item to include in search results.

Available options:
posts,
news,
developments,
tweets,
youtube
​
limit
integer
default:25

Maximum number of content items to return.

Required range: 1 <= x <= 100
​
days_back
integer
default:7

Lookback window for recent and auto searches.

Required range: 1 <= x <= 90
​
sort_by
enum<string>
default:relevance

Result ordering. Use relevance for scored results or date for newest-first results.

Available options:
date,
relevance
​
minimum_relevance_score
number
default:0.2

Minimum relevance threshold used to suppress lower-quality semantic matches.

Required range: 0 <= x <= 1
​
ecosystems
enum<string>[]

Ecosystem slug filters. Supports up to 5 values.

Maximum array length: 5
Available options:
bitcoin,
ethereum,
solana,
base,
optimism,
arbitrum,
celestia,
monad,
binance-smart-chain,
bsc,
megaeth,
eclipse,
movement,
aptos,
sui,
avalanche,
polygon,
scroll,
berachain,
sonic,
hyperliquid,
unichain,
near,
hedera,
ronin,
cosmos,
ripple,
bittensor,
virtuals,
telegram,
ton,
tron,
cardano,
zksync,
blast,
linea,
stacks,
celo,
starknet,
sei,
farcaster,
abstract
Example:
​
categories
enum<string>[]

Category slug filters. Supports up to 5 values.

Maximum array length: 5
Available options:
defi,
derivatives,
rwas,
rwa,
nfts,
nft,
gaming,
ai,
socialfi,
daos,
dao,
memecoins,
memecoin,
stablecoins,
stablecoin,
ecosystems,
rollups,
rollup,
zk,
interoperability,
depin,
wallets,
wallet,
consumer,
robotics,
prediction-markets
Example:
​
project_ids
integer[]

Project IDs to restrict the search to specific projects.

Maximum array length: 25
​
image_limit
integer

Maximum number of images to include per content item.

Required range: 1 <= x <= 10
​
include_analysis
boolean
default:false

Include AI-generated analysis for semantic searches.

​
snippet_limit
integer | null

Maximum number of relevant text snippets to include per item when a query is provided.

Required range: 1 <= x <= 5

Response

Content search results.

​
success
boolean
required
​
error
string | null
required
​
content
object[]
required
​
analysis
object
​
metadata
object