Twitter Account Monitoring API - Introduction

SocialData Monitoring API provides a convenient way to monitor actions by target users and receive notifications.

The monitoring API

Five types of monitors are currently supported:

• User Tweets Monitor - triggered when a user posts a new tweet or makes a new retweet to deliver a nearly instant update
• User Following Monitor - triggered when a user follows a new account to deliver a nearly instant update
• User Profile Monitor - triggered when a user makes a change to their Twitter profile information (e.g. bio, location or a website) to deliver a nearly instant update
• Search Query Monitor - triggered with a frequency you define and retrieves search results for any custom search query
• Pump.Fun Monitor - triggered when a new link to pump.fun coin page is posted by any user with at least 1000 followers (only detects non shadow-banned users, i.e. visible in Twitter search)

Once a monitor detects the new tweet or followed user - it will trigger a webhook call to your backend with complete tweet & user data. Refer to Processing webhook events page for details on webhook payload.

Getting Started

1. Obtain your SocialData API key
2. Set up your webhook handler

• Create a webhook endpoint on your own server to handle received webhook events
• Or expose your local development environment through a public URL using Ngrok or Cloudflare Tunnel - only recommended while testing, but not for production-ready applications

3. Set the webhook URL where you will receive updates:

• Use POST /user/webhook endpoint to set a single default webhook URL that will receive events from all current and future monitors
• Or set webhook_url property when creating a new monitor to assign an individual webhook URL to each of your monitors

4. Create your first monitor

Tip

We recommend setting a single default webhook URL instead of individual URLs for each monitor. Each webhook payload contains sufficient information to determine which monitor triggered the event.

Receiving Events in Telegram or Discord

To simplify the process of receiving notifications in your Discord channel or Telegram bot, we provide pre-built webhook handlers hosted on Val Town, eliminating the need to develop your own custom application.

Simply fork one of these handlers and configure your monitor’s webhook_url to direct events to your Val Town application:

• New tweet event webhook handler
• User following event webhook handler
• User profile update webhook handler

Val Town is a robust platform for creating, executing, and sharing lightweight JavaScript or TypeScript code snippets directly in your browser, offering a simple and efficient solution for rapid deployment without complex infrastructure.