Twitter Account Monitoring API - Introduction

Limited Access

The Monitoring API is currently in limited release. To request access, please contact our support team at [email protected] or use our live chat support feature.

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

Three types of monitors are currently supported:

• User tweets monitor - triggered when a user posts a new tweet or makes a new retweet
• User following monitor - triggered when a user follows a new account
• User profile monitor - triggered when a user makes a change to their Twitter profile information (e.g. bio, location or a website)

Once a monitor detects the new tweet or followed user - it will trigger a webhook call to your backend with complete tweet & user data

Getting Started

1. Obtain your SocialData API key
2. Set the webhook URL where you will receive updates:

• Use POST /user/webhook endpoint to set a single global 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

3. Create your first monitor

Tip

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