Search

Search the Droyd knowledge base for crypto content including articles, news, tweets, YouTube videos, and more.

POST /api/v1/search | GET /api/v1/search

Auth: API Key or x402

POST Examples

Recent Content Search:

curl -X POST https://api.droyd.ai/api/v1/search \
  -H "x-droyd-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "search_mode": "recent",
    "content_types": ["posts", "news"],
    "ecosystems": ["ethereum", "base"],
    "categories": ["defi"],
    "days_back": 7,
    "limit": 25
  }'

Semantic Search:

curl -X POST https://api.droyd.ai/api/v1/search \
  -H "x-droyd-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "search_mode": "semantic",
    "query": "What are the top performing AI agents this week?",
    "content_types": ["posts", "tweets", "youtube"],
    "ecosystems": ["solana", "base"],
    "limit": 50,
    "include_analysis": false
  }'

Auto Mode (automatically determines search type):

curl -X POST https://api.droyd.ai/api/v1/search \
  -H "x-droyd-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "search_mode": "auto",
    "query": "What happened today in crypto?",
    "ecosystems": ["ethereum"]
  }'

GET Examples

# Recent content
curl -X GET "https://api.droyd.ai/api/v1/search?types=posts,news&ecosystems=ethereum,base&categories=defi&days_back=7&limit=25" \
  -H "x-droyd-api-key: YOUR_API_KEY"
 
# Semantic search
curl -X GET "https://api.droyd.ai/api/v1/search?q=AI+agents+on+Solana&mode=semantic&types=posts,tweets&limit=50" \
  -H "x-droyd-api-key: YOUR_API_KEY"
 
# Auto mode
curl -X GET "https://api.droyd.ai/api/v1/search?q=What+happened+today+in+crypto&ecosystems=ethereum" \
  -H "x-droyd-api-key: YOUR_API_KEY"

Response

{
  "success": true,
  "analysis": "Recent AI agent projects show...",
  "content": [
    {
      "post_id": 12345,
      "title": "AI Agents on Solana",
      "summary": "Analysis of AI agent frameworks...",
      "post_link": "https://...",
      "published_date": "2025-01-05T10:00:00Z",
      "source_name": "CryptoDaily",
      "projects": [
        {
          "project_id": 789,
          "project_name": "Virtuals Protocol"
        }
      ]
    }
  ],
  "metadata": {
    "content_types": ["posts", "tweets", "youtube"],
    "days_back": 7,
    "total_results": 50,
    "limit": 50
  }
}

Request Parameters

Parameter	Type	Required	Default	Description
`search_mode`	string	No	`auto`	`recent`, `semantic`, or `auto` (auto determines based on query)
`query`	string	Conditional	-	Required for semantic or auto search
`content_types`	string[]	No	`["posts", "news", "developments", "tweets", "youtube"]`	Content types to search
`limit`	number	No	`25`	Results limit (1-100)
`days_back`	number	No	`7`	Days to look back (1-90)
`sort_by`	string	No	`relevance`	`relevance` or `date`
`minimum_relevance_score`	number	No	`0.2`	Min score threshold (0-1)
`ecosystems`	string[]	No	-	Ecosystem slugs (max 5)
`categories`	string[]	No	-	Category slugs (max 5)
`project_ids`	number[]	No	-	Project IDs (max 25)
`image_limit`	number	No	-	Max images per item (1-10)
`include_analysis`	boolean	No	`false`	Include AI analysis (semantic only)
`snippet_limit`	number	No	-	Max text snippets per item (1-5, only with query)

Valid Content Types

posts - Long-form articles and blog posts
news - News articles
developments - Project updates and milestones
tweets - Twitter/X posts
youtube - YouTube videos
memories - Agent memories
concepts - Conceptual knowledge

Tips

Use semantic when you have a specific question or need AI analysis
Use recent for broad discovery or time-sensitive content
Adjust minimum_relevance_score to filter noise — 0.1 for more results, 0.5+ for high quality only
Combine ecosystems + categories for targeted research
Mix content types for comprehensive coverage: posts + news for long-form analysis, tweets + YouTube for real-time sentiment