Skip to main content
POST
https://api.kanarie.xyz
/
api
/
v1
/
content
/
search
curl --request POST \
  --url https://api.kanarie.xyz/api/v1/content/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "search_mode": "semantic",
  "query": "latest DeFi trends on Solana",
  "content_types": [
    "posts",
    "tweets",
    "news"
  ],
  "ecosystems": [
    "solana"
  ],
  "limit": 10,
  "include_analysis": true
}
'
{
  "success": true,
  "error": null,
  "content": [
    {
      "title": "DeFi TVL hits new highs",
      "summary": "Example content item",
      "source_name": "twitter"
    }
  ],
  "metadata": {
    "total_results": 1,
    "limit": 10
  }
}

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:
["solana"]
​
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:
["defi"]
​
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