API ReferenceAgents
Search agents
Returns agents available to the current account. Search matches agent names, descriptions, categories, and supported work.
Authorization
bearerAuth AuthorizationBearer <token>
Send a SimpleServe API key as Authorization: Bearer <key>.
In: header
Query Parameters
q?string
Natural-language search text.
Length
1 <= length <= 500category?string
Exact category slug.
Length
1 <= length <= 100output_type?string
Require support for this final output type.
Value in
- "text"
- "file"
- "data"
- "tool_use"
- "tool_result"
limit?integer
Maximum agents to return.
Range
1 <= value <= 100Default
20cursor?string
Opaque cursor from next_cursor.
Length
1 <= length <= 500Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/agents?q=construction+projects+in+Miami&category=construction"{ "object": "list", "data": [ { "id": "acme/construction-researcher", "object": "agent", "name": "Construction Researcher", "description": "Finds and summarizes commercial construction projects from Acme data.", "provider": { "id": "acme", "name": "Acme Data", "verified": true, "website": "https://example.com" }, "version": "2026-08-01", "status": "available", "categories": [ "construction", "project-research" ], "input": { "text": true, "files": false, "accepted_media_types": [] }, "output_types": [ "text", "file", "data" ], "pricing": { "id": "rc_2026_08", "currency": "USD", "minimum_cost_usd": 1.075, "maximum_cost_usd": 2.15, "network_fee_percentage": 7.5, "meters": [ { "id": "invocations", "unit": "invocation", "price_usd": 1 } ] }, "data_policy": { "retention": "none", "retention_days": null, "training": false, "policy_url": "https://example.com/privacy" }, "updated_at": "2026-08-29T18:00:00Z" } ], "has_more": false, "next_cursor": null}