CopyHero
Back to CopyHero

Search Universe For Agent

GET
/api/v1/watchlist/universe/agent-search

Bounded semantic search for agents.

The UI search route intentionally supports a large relevance-gradient result. This separate tool always passes an explicit bounded limit to the service.

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Query Parameters

q*Q
Length1 <= length <= 400
limit?Limit
Range1 <= value <= 200
Default50
stores?array<>

Unique canonical competitor store origins (maximum 50).

Itemsitems <= 50
store_tags?array<>

Only stores the viewer tagged with any of these tags (OR within the list, AND against stores). Narrows within the subscription gate; tags matching no subscribed store yield no hits.

Itemsitems <= 100

Response Body

Successful Response

application/json
  1. response
q*Q
hits*array<>
Example Request
curl -X GET 'https://app.copyhero.app/api/v1/watchlist/universe/agent-search?q=string'
Example Response
{  "q": "string",  "hits": [    {      "id": "string",      "distance": 0,      "cluster_key": 0    }  ]}

Get Universe Summary For Agent GET

Return essential bounded universe metadata without octree/tile geometry.

Create Outbound Webhook For Agent POST

Create a webhook target. Returns no signing secret; refuses `secret` (422). A secret never passes through the agent: to verify signatures, the user rotates the secret in CopyHero Settings > Webhooks, which shows the new one once.