{"uid":"cap_K9NRWCbZ6niPMLNf3QNm5","slug":"2s-package-release-watcher-39a57cb9","name":"2s Package Release 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/package-release","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"name":{"type":"string","maxLength":120,"minLength":1,"description":"Package name, e.g. react (npm) or requests (pypi)."},"label":{"type":"string","maxLength":64,"description":"Optional free-text tag."},"payload":{"type":"object","description":"Arbitrary JSON echoed back in every callback.","additionalProperties":{}},"maxFires":{"type":"integer","maximum":1000,"minimum":1,"description":"Stop after this many releases (default 10)."},"registry":{"enum":["npm","pypi"],"type":"string","description":"Package registry: npm or pypi."},"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_dGTu29Icf0fEJr1VinWOi","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":"Registers a webhook watcher that fires a signed callback whenever a new version of a specified npm or PyPI package is released","exampleAgentPrompt":"Set up a watcher on npm for the 'react' package — send a POST to https://myapp.example.com/hooks/releases with my payload {\"project\":\"frontend\"} whenever a new version drops, stop after 5 releases, and keep the watcher active for 30 days.","exampleUseCases":null,"resultDescription":"A JSON object with ok: true, an items array containing the created watcher record, total count, and a source object describing the upstream provider URL, license, and provider name.","failureModes":["Invalid or unsupported registry value (must be npm or pypi)","Package name not found in the specified registry","callbackUrl is not a valid http/https URL","expiresInSeconds exceeds maximum of 7,776,000 (90 days)","maxFires exceeds maximum of 1000","Payment not provided or insufficient USDC balance","Callback URL is unreachable or returns errors when 2s attempts delivery"],"whenToPreferThis":"Use this endpoint when you need event-driven notifications for new package releases on npm or PyPI without polling — especially when building CI/CD pipelines, dependency update bots, or security monitoring systems that need to react immediately when a library version changes. Prefer this over manual polling or GitHub Action triggers when the package source is PyPI or npm specifically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:55:38.632Z","isFirstParty":false}