Skip to main content
GET
https://api.kanarie.xyz
/
api
/
v1
/
content
/
search
Search content
curl --request GET \
  --url https://api.kanarie.xyz/api/v1/content/search \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "error": null,
  "content": [
    {
      "title": "DeFi TVL hits new highs",
      "summary": "Example content item",
      "source_name": "twitter"
    }
  ],
  "metadata": {
    "total_results": 1,
    "limit": 10
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.kanarie.xyz/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
default:YOUR_KANARIE_API_KEY
required

Preferred Kanarie API key authentication using Authorization: Bearer .

Query Parameters

​
q
string

Semantic query string. Required when mode is semantic or auto.

Example:

"latest DeFi trends on Solana"

​
mode
enum<string>
default:auto

Search mode. If q is present and mode is omitted, the API defaults to auto.

Available options:
recent,
semantic,
auto
​
types
string

Comma-separated content types.

Example:

"posts,tweets,news"

​
limit
integer
default:25

Maximum number of results.

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

Number of days to look back.

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

Sort order for content results.

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

Minimum relevance score threshold.

Required range: 0 <= x <= 1
​
ecosystems
string

Comma-separated ecosystem slugs.

Example:

"solana,base"

​
categories
string

Comma-separated category slugs.

Example:

"defi,ai"

​
project_ids
string

Comma-separated project IDs.

Example:

"1,2"

​
image_limit
integer

Maximum images per content item.

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

Whether to include AI-generated analysis.

​
snippet_limit
integer

Maximum text snippets per content item.

Required range: 1 <= x <= 5
​
scope
string

Comma-separated content owner scopes.

Example:

"agent,swarm"

Response

Content search results.

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