v6

latestOpenAPI 3.0.0raw.githubusercontent.com2025-03-123918105.6 KB
Monitoring API

Create New User Tweets Monitor

Creates a new monitor to receive alerts when the target Twitter user posts a new tweet or makes a retweet. When adding a new monitor SocialData will attempt to fetch user details and return HTTP Status 422 in case the user timeline is protected or user not found.

post/monitors/user-tweets

Request body

OR

Example request

{
  "user_screen_name": "elonmusk",
  "webhook_url": "https://my-website.com/webhook"
}

Response

Monitor created successfully

statusstring

Example response

{
  "status": "success",
  "data": {
    "id": "01jhfkd7xsvy6afdmwycs1qn61",
    "created_at": "2025-01-13T15:30:02.000000Z",
    "monitor_type": "user_tweets"
  }
}