UniCatcher

Use the UniCatcher capability for low-noise Twitter and Reddit intelligence with status, monitor coverage, and paid evidence retrieval.

UniCatcher is the first listed marketplace capability. It retrieves low-noise, filtered, and categorized Twitter and Reddit evidence for agents that need fresh intelligence rather than a general model answer.

Use UniCatcher when the task asks for recent, evidence-grounded social intelligence: hot tweets, topic movement, monitored account activity, early signals, or low-noise summaries from tracked sources.

Capability ID

Field	Value
Capability slug	`unicatcher-query`
Default version	`v1`
Type	`api`
Category	`intelligence`
Default operation	`query`
Default mode	`sync`

Recommended Flow

Call status to check freshness and runtime health.
Call monitors to confirm the topic is actively covered.
Call query only when the status and monitor coverage are acceptable.

Status and monitors are helper reads. Query is the paid evidence retrieval operation. The default query price is 10000 micro USDC, equal to 0.01 USDC, but agents should always read the live descriptor before calling.

Operation Matrix

Operation	Path	Price	Purpose
`status`	`GET /v1/capabilities/unicatcher-query/operations/status`	Usually `0` micro USDC	Check freshness, degradation, runtime health, and recommended maximum data age.
`monitors`	`GET /v1/capabilities/unicatcher-query/operations/monitors`	Usually `0` micro USDC	List active monitor scopes before paying for a full query.
`query`	`POST /v1/capabilities/unicatcher-query/invoke`	Default `10000` micro USDC	Retrieve grounded evidence, confidence, coverage, freshness, and warnings.

Status

curl "$XENODIA_BASE_URL/v1/capabilities/unicatcher-query/operations/status" \
  -H "Authorization: Bearer $XENODIA_API_KEY"

Use status first for time-sensitive work. If the response reports degraded freshness, offline workers, or stale data, lower trust in downstream query results.

Expected output highlights include:

degraded
sourceFreshness
runtimeHealth
recommendedMaxDataAgeMinutes

List Monitors

curl "$XENODIA_BASE_URL/v1/capabilities/unicatcher-query/operations/monitors?status=active&platform=twitter&limit=20" \
  -H "Authorization: Bearer $XENODIA_API_KEY"

Supported query parameters:

Name	Type	Meaning
`status`	string	Optional monitor status filter, such as `active`.
`platform`	string	Optional platform filter, such as `twitter`.
`cursor`	string	Optional pagination cursor.
`limit`	integer	Optional page size.

Use monitor results to decide whether the desired topic is inside UniCatcher's active coverage universe.

Query Intelligence

curl "$XENODIA_BASE_URL/v1/capabilities/unicatcher-query/invoke" \
  -H "Authorization: Bearer $XENODIA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unicatcher-query-topic-2026-05-04T10-00-00Z" \
  -d '{
    "query": "Find the highest-signal developments around the monitored topic in the last 24 hours.",
    "filters": {
      "sourceTypes": ["twitter", "reddit"],
      "screeningStatus": ["qualified", "review"],
      "timeRangeHours": 24,
      "limit": 20,
      "sort": "publishedAt:desc"
    },
    "responseMode": "evidence_only"
  }'

Request fields:

Field	Type	Meaning
`query`	string	Required natural-language retrieval instruction.
`filters.sourceTypes`	string array	Optional source filters such as `twitter` and `reddit`.
`filters.monitorIds`	string array	Optional monitor IDs discovered from `monitors`.
`filters.labelIds`	string array	Optional category or label filters.
`filters.screeningStatus`	string array	Optional quality filters such as `qualified` and `review`.
`filters.timeRangeHours`	integer	Optional freshness window.
`filters.limit`	integer	Optional evidence count.
`filters.sort`	string	Optional sort, for example `publishedAt:desc`.
`responseMode`	string	Prefer `evidence_only`; use summarization modes only when the agent explicitly wants upstream summarization.
`includeEvidence`	boolean	Optional evidence inclusion flag.
`includeRaw`	boolean	Optional raw provider payload flag when supported.

Interpreting Results

Inspect returned confidence, coverage, freshness, and warnings before acting. If warnings or degraded freshness are present, tell the user that the result is lower confidence instead of presenting it as a complete real-time view.

For audit, retain:

request_id
capability
operation
capability_version
billing.status
billing.actual_amount_micro_usdc
the filter summary used for the query

Legacy Compatibility

POST /v1/capabilities/unicatcher/query remains a compatibility route for the query operation. New integrations should prefer the generic capability routes because they work for every marketplace capability.

UniCatcher

On this page