watches
Know when a competitor changes course
Watch an app or a whole niche in the markets you choose. When something changes, threefold sends a signed webhook, an email, or both.
What a watch notices
A new title, description, screenshot set or price in a storefront, with what it changed from and to.
A chart move of at least the threshold you set (default 5 places) in a watched market.
A new ad from the watched app. This needs Paid data, which arrives as ad-library connections go live.
Changes are detected by the ingest worker from listing history, chart snapshots and collected ads, so a watch sees what the library sees, at the library's refresh rate. Each event is delivered once.
Create one
From an agent, call the workspace tool with action: "watch" (see Agent tools). Over HTTP:
curl -X POST https://api.threefold.eco/api/watches \
-H "Authorization: Bearer tf_live_your_key" \
-H "Content-Type: application/json" \
-d '{
"target_type": "app",
"target_id": "529479190",
"markets": ["es", "de"],
"events": ["listing", "rank", "ad"],
"threshold": 5,
"webhook_url": "https://example.com/threefold-hook",
"webhook_secret": "your-secret"
}'Webhooks are signed with HMAC-SHA256 in the X-Threefold-Signature header (sha256=<hex>), and webhook URLs must be public addresses. Over HTTP, GET /api/watches and POST /api/watches/:id/delete manage the rest.
Watches are on the Team plan (up to 10) and Enterprise (no set limit), with a monthly charge per watch while prices are in beta. See Pricing. The competitor-watch skill walks an agent from finding competitors to setting watches.
Stop checking the charts by hand
Events, payloads and signature checks are in the watches docs.