Search Sites - Danube

curl -X GET "https://api.danubeai.com/v1/agent-sites/search?q=payment+processing&limit=5"

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    sites = client.sites.search(query="payment processing", limit=5)
    for site in sites:
        print(f"{site.domain}: {site.page_description}")

[
  {
    "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"
  }
]

GET

agent-sites

curl -X GET "https://api.danubeai.com/v1/agent-sites/search?q=payment+processing&limit=5"

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    sites = client.sites.search(query="payment processing", limit=5)
    for site in sites:
        print(f"{site.domain}: {site.page_description}")

[
  {
    "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

string

required

Search query (e.g., payment processing, email marketing)

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"

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    sites = client.sites.search(query="payment processing", limit=5)
    for site in sites:
        print(f"{site.domain}: {site.page_description}")

[
  {
    "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
})

List Sites Get Site by Domain

​Overview

​Query Parameters

​Response

​Example

​MCP Tool

Overview

Query Parameters

Response

Example

MCP Tool