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
}
}{
"error": "Validation failed",
"details": [
"limit must be a number between 1 and 100"
]
}{
"error": "Missing API key. Expected Authorization: Bearer <api-key> or x-kanarie-api-key: <api-key>."
}{
"x402Version": 2,
"error": "Payment required",
"accepts": [
{}
]
}{
"error": "Invalid API key"
}{
"error": "Rate limit exceeded",
"limit": 123,
"plan": "casual",
"window": "15 minutes",
"retryAfter": 900
}{
"error": "Internal server error"
}Search content
Search the Kanarie content index with a JSON body. Supports API key auth or x402 fallback.
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
}
}{
"error": "Validation failed",
"details": [
"limit must be a number between 1 and 100"
]
}{
"error": "Missing API key. Expected Authorization: Bearer <api-key> or x-kanarie-api-key: <api-key>."
}{
"x402Version": 2,
"error": "Payment required",
"accepts": [
{}
]
}{
"error": "Invalid API key"
}{
"error": "Rate limit exceeded",
"limit": 123,
"plan": "casual",
"window": "15 minutes",
"retryAfter": 900
}{
"error": "Internal server error"
}Authorizations
Preferred Kanarie API key authentication using Authorization: Bearer .
Body
Search strategy. Use recent for chronological filtering, semantic for similarity search, or auto to let Kanarie choose.
recent, semantic, auto Semantic query string. Required when search_mode is semantic and recommended when search_mode is auto.
Content surfaces to search.
Type of content item to include in search results.
posts, news, developments, tweets, youtube Maximum number of content items to return.
1 <= x <= 100Lookback window for recent and auto searches.
1 <= x <= 90Result ordering. Use relevance for scored results or date for newest-first results.
date, relevance Minimum relevance threshold used to suppress lower-quality semantic matches.
0 <= x <= 1Ecosystem slug filters. Supports up to 5 values.
5bitcoin, 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 ["solana"]
Category slug filters. Supports up to 5 values.
5defi, 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 ["defi"]
Project IDs to restrict the search to specific projects.
25Maximum number of images to include per content item.
1 <= x <= 10Include AI-generated analysis for semantic searches.
Maximum number of relevant text snippets to include per item when a query is provided.
1 <= x <= 5Was this page helpful?