Sign in

v1

latestOpenAPI 3.1.02026-08-044257268.7 KB
Discover

Semantic endpoint search (ranked cards)

The shared discover pipeline projected as public endpoint cards in ranked order — the semantic twin of GET /public/v1/endpoints?q=. Cards carry categories node-id tags for client-side grouping.

post/v1/discover/endpoints

Request body

qstring required

Natural-language search query.

limitinteger

Max results. Capped at the discover over-fetch pool size (service.discover.overfetch_size).

categorystring

Optional category node id to narrow the ranked results (ids from GET /public/v1/categories; a top id covers its group).

minScorenumber

Per-call override for the post-rerank score floor — same semantics as the legacy POST /v1/discover body field.

Example request

{
  "q": "twitter posts",
  "limit": 200,
  "category": "twitter",
  "minScore": 0.2
}

Response

Ranked endpoint cards

totalinteger required

Above-floor semantic matches (after the optional category narrowing), before limit truncation.

Example response

{
  "items": [
    {
      "provider": "exa",
      "endpoint": "/search"
    }
  ]
}