Loading...
searchstack.dev
Sign In

React to what changes

The feed keeps your list fresh on its own. Sometimes your app needs to do something when it does — clear a cache, re-render a page, notify a team. Webhooks tell you the moment it happens.

Subscribe to record events

A webhook is a URL of yours that Search Stack calls when something happens. Subscribe to record events on your catalog list and, each time the feed adds, updates or deactivates a record, Search Stack posts to your endpoint — so you learn about a change without polling for it. 

POST https://api.searchstack.dev/webhook/Demo
X-API-Key: {your key}
Content-Type: application/json

{
  "target_url": "https://yourapp.com/hooks/searchstack",
  "events": ["searchresult.created", "searchresult.updated", "searchresult.deactivated"]
}

What you receive

When the feed's next sync brings a change, your endpoint gets a small POST describing it — enough to act on without re-fetching everything:

{
  "event": "searchresult.deactivated",
  "account": "Demo",
  "list": "catalog",
  "id": "sku-1003"
}

Now the loop is closed: your system changes, the feed carries it into search, and the webhook carries it into your app — a product sells out in your database, drops from search on the next sync, and your storefront clears its cached tile the instant it does. Verify the signature on each call so you know it really came from Search Stack, and you have a dependable, hands-off pipeline.

Go deeper: Webhooks — events, delivery and signing in the reference.

Top