Skip to main content
GET
/
v1
/
agent-sites
/
search
curl -X GET "https://api.danubeai.com/v1/agent-sites/search?q=payment+processing&limit=5"
[
  {
    "id": "site_abc123",
    "domain": "stripe.com",
    "url": "https://stripe.com",
    "status": "live",
    "page_title": "Stripe | Payment Processing Platform",
    "page_description": "Online payment processing for internet businesses",
    "favicon_url": "https://stripe.com/favicon.ico",
    "component_count": 6,
    "tool_count": 3,
    "category": "finance",
    "tags": ["payments", "api"],
    "created_at": "2026-01-10T08:00:00Z"
  }
]

Overview

Searches the agent-friendly site directory using semantic search. Returns sites matching the query based on their content, description, and extracted components. Only returns live, public sites. No authentication required.

Query Parameters

q
string
required
Search query (e.g., payment processing, email marketing)
category
string
Filter by category
limit
integer
default:"20"
Maximum number of results (max 100)

Response

Returns an array of site summary objects. See List Sites for the full object shape.

Example

curl -X GET "https://api.danubeai.com/v1/agent-sites/search?q=payment+processing&limit=5"
[
  {
    "id": "site_abc123",
    "domain": "stripe.com",
    "url": "https://stripe.com",
    "status": "live",
    "page_title": "Stripe | Payment Processing Platform",
    "page_description": "Online payment processing for internet businesses",
    "favicon_url": "https://stripe.com/favicon.ico",
    "component_count": 6,
    "tool_count": 3,
    "category": "finance",
    "tags": ["payments", "api"],
    "created_at": "2026-01-10T08:00:00Z"
  }
]

MCP Tool

This endpoint is also available as the search_sites MCP tool:
result = await mcp.call_tool("search_sites", {
    "query": "payment processing",
    "limit": 5
})