{"uid":"cap_oh4Av3kScpP2ZAMDJ634a","slug":"2s-whois-domain-watcher-81af7133","name":"2s WHOIS Domain Watcher","description":"The (most) everything API: 575+ pay-per-call endpoints for AI agents — ground-truth data, a full AI gateway, and agent infrastructure (storage, queues, watchers). USDC via x402, no signup, no API keys, and upto billing: pay actual usage, not the quote.","url":"https://2s.io/api/watchers/whois","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"label":{"type":"string","maxLength":64,"description":"Optional free-text tag."},"domain":{"type":"string","maxLength":255,"minLength":3,"description":"Domain to monitor, e.g. example.com."},"payload":{"type":"object","description":"Arbitrary JSON echoed back in every callback.","additionalProperties":{}},"maxFires":{"type":"integer","maximum":1000,"minimum":1,"description":"Stop after this many changes (default 10)."},"callbackUrl":{"type":"string","maxLength":2048,"description":"Signed event POSTed here (verify X-2s-Signature). Any http(s) URL."},"expiresInSeconds":{"type":"integer","maximum":7776000,"minimum":60,"description":"Active window in seconds (default 30d, max 90d)."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.125","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.125/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.125","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.125","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_okW2FruQF2VFjrpY-YyrH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.125","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Sets up a persistent watcher that monitors a domain's WHOIS record and POSTs a signed callback whenever changes are detected","exampleAgentPrompt":"Set up a WHOIS change watcher on competitor.com for the next 30 days — send callbacks to https://hooks.myapp.com/whois-alert and stop after 5 changes.","exampleUseCases":[{"title":"Competitor domain acquisition alert","prompt":"Watch the WHOIS record for rival-brand.com and POST a signed notification to https://myserver.io/alerts/whois whenever anything changes — keep it active for 60 days and stop after 3 events."},{"title":"Brand protection domain monitoring","prompt":"Set up a WHOIS watcher on mybrand.io for 90 days, with callbacks going to https://compliance.example.com/webhook — alert me up to 10 times if ownership, registrar, or expiry details change."},{"title":"Domain expiry and drop catching","prompt":"Monitor expiring-domain.net via WHOIS for the next 14 days and notify https://hooks.myagent.com/drop with a JSON payload of {\"campaign\":\"acquisition\"} every time the record changes, up to 5 times."}],"resultDescription":"Returns a watcher object with a unique watcher ID and confirmation that monitoring is active. Subsequently, whenever the target domain's WHOIS record changes, a signed HTTP POST is sent to the provided callbackUrl containing the diff, the echoed custom payload, and an X-2s-Signature header for verification. The watcher deactivates after maxFires events or after the expiresInSeconds window elapses.","failureModes":["Invalid or unresolvable domain returns a 422 validation error","callbackUrl that is unreachable or returns non-2xx causes delivery retries then potential watcher suspension","expiresInSeconds exceeding 7776000 (90 days) returns a validation error","maxFires outside 1–1000 range rejected","Payment failure via x402 prevents watcher creation","Malformed callback signature verification on the receiver side is a client-side misconfiguration, not an API error"],"whenToPreferThis":"Choose this endpoint when you need continuous, asynchronous monitoring of a domain's WHOIS record over a defined window rather than a one-shot lookup. It is ideal for brand protection, competitive intelligence, domain acquisition targeting, and compliance use cases where you want to be notified of ownership, registrar, nameserver, or expiry changes without polling manually. Prefer it over a simple WHOIS lookup endpoint when the goal is ongoing surveillance rather than a single snapshot.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:10:43.955Z","isFirstParty":false}