CopyHero
Back to CopyHero

Get Universe Summary For Agent

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

Return essential bounded universe metadata without octree/tile geometry.

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Query Parameters

store_limit?Store Limit
Range1 <= value <= 50
Default20
cluster_limit?Cluster Limit
Range1 <= value <= 100
Default50
store_tags?array<>|

Only stores the viewer tagged with any of these tags (OR within the list, AND against every other filter). Narrows within the subscription gate; never widens it — tags matching no subscribed store yield an EMPTY result, never an unfiltered one.

Response Body

Successful Response

application/json
  1. response

Bounded research metadata without UI octree/tile geometry.

version_id*Version Id
n_total*N Total
stores*array<>
stores_total*Stores Total
clusters*array<>
clusters_total*Clusters Total
Example Request
curl -X GET 'https://app.copyhero.app/api/v1/watchlist/universe/agent-summary'
Example Response
{  "version_id": "string",  "n_total": 0,  "stores": [    {      "url": "string",      "count": 0    }  ],  "stores_total": 0,  "clusters": [    {      "key": 0,      "label": "string",      "count": 0,      "level": 0    }  ],  "clusters_total": 0}

Get Universe Product GET

Click-detail for one universe point, addressed by ``internal_product_id`` (deliberate — see module docstring). 404 when the viewer has no live subscription to the product's store, or no such product exists.

Search Universe For Agent GET

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.