mentions

Create Watch

post/v1/mentions/watches

Request

  • Base URL: https://api.snoopscan.com
  • URL: https://api.snoopscan.com/v1/mentions/watches
  • Auth: none declared

Headers

authorizationstring nullable

Request body

keywordsstring[]

Words or phrases to look for, up to 20 with competitors. Whole words, any case.

competitorsstring[]

Keywords for a competitor. A post that matches one of these and none of keywords is sorted as competitor.

excludestring[]

Words that remove a post from the results when it contains any of them.

platformsstring[] nullable

Where to look: reddit, hackernews, bluesky, youtube, threads, web, github, feeds. Default is all of them.

feedsstring[] nullable

RSS or Atom feed addresses to read (a Substack, a blog, a forum), up to 10. Read when platforms includes feeds; new entries that name a keyword as a whole word become mentions.

categoriesstring[] nullable

Categories to keep: bug_report, complaint, question, buying_intent, praise, competitor, other. Posts sorted elsewhere are dropped. Default is all.

customWordsobject nullable

Your own words for a category, added to the built-in ones. Example: {"buying_intent": ["any tips"]}.

intervalMinutesinteger nullable

How often to check, in minutes: 5 to 10,080. Default 15.

namestring required

A name for the watch.

webhookstring nullable

A URL to POST to with mention.created for each new mention. Signed with your key's webhook secret.

Response

Successful Response

object required

Changes

No recorded changes to this operation across all 1 revision of this API.