Signals API · private beta first

Structured geo/ops event signals for teams that need delivery, not just headlines.

ZettaWire Signals API packages the verified event stream behind customer keys, usage visibility, archive windows, and beta webhook controls. Public access stays lightweight; paid access unlocks deeper archive and operational delivery.

Manage API access Request beta access

Signals shape

GET /api/v1/stories?category=maritime&page=1

{
  "story_id": "signal-18431",
  "headline": "Port disruption near Suez corridor",
  "category": "Logistics",
  "geo": {"country": "EG", "lat": 30.04, "lng": 32.56},
  "engagement": {"total_reactions": 41},
  "briefing_url": "/briefing/port-disruption-near-suez-corridor"
}

Event-first schema

Built around geopolitical and operational signals instead of generic article search.

Geo + ops context

Categories, geodata, engagement context, and briefing links stay attached to each event.

Customer API controls

Issued keys, live rate posture, archive window visibility, and usage summaries in one place.

Webhook rollout

Growth and Enterprise customers can manage private-beta webhook delivery from the same surface.

Packaging

Anonymous access stays separate from paid Signals API access.

Keep lightweight evaluation public. Move teams to account-backed keys once they need archive depth, higher throughput, or webhook delivery.

Public access

Anonymous

Rolling public signal endpoints for lightweight integrations and evaluation.

Rate: 60 requests/hr
Archive: 24 hour rolling window
Delivery: No customer keys

Signals Starter

Paid

Structured geo/ops event endpoints with self-serve keys for analyst workflows and internal tools.

Rate: 1,000 requests/hr
Archive: 30 day event archive
Delivery: 2 keys included

Signals Growth

Private beta

Longer archive access, higher throughput, and private-beta webhook delivery for production teams.

Rate: 5,000 requests/hr
Archive: 12 month archive
Delivery: 5 keys + webhook beta

Signals Enterprise

Custom

High-volume account routing, tailored categories, private-beta delivery controls, and extended archive access.

Rate: 25,000 requests/hr
Archive: 24 month archive
Delivery: Managed rollout

Included endpoints

Structured delivery surfaces already map to the live product.

/api/v1/stories

/api/v1/stories/{story_id}

/api/v1/stories/{story_id}/engagement

/api/v1/categories

/api/v1/trending

/api/v1/briefings

Webhook rollout

Private-beta delivery controls live in the customer console.

Growth and Enterprise accounts can manage webhook endpoints, secrets, delivery status, and recent failures without jumping to internal ops tooling.

Customer-visible webhook URL and secret status
24h delivery and failure visibility
Same access surface reused for invite-only launch