POST users/report_spam

Report the specified user as a spam account to Twitter. Additionally, optionally performs the equivalent of POST blocks / create on behalf of the authenticated user.

Resource URL

https://api.twitter.com/1.1/users/report_spam.json

Resource Information

Response formats JSON
Requires authentication? Yes (user context only)
Rate limited? Yes

Parameters

Name Required Description Default Value Example
screen_name optional The screen_name of the user to report as a spammer. Helpful for disambiguating when a valid screen name is also a user ID. twitterdev
user_id optional The ID of the user to report as a spammer. Helpful for disambiguating when a valid user ID is also a valid screen name. 12345
perform_block optional Whether the account should be blocked by the authenticated user, as well as being reported for spam. true false

Example Request

POST https://api.twitter.com/1.1/users/report_spam.json?screen_name=twitterdev&perform_block=false

Example Response

{
  "id": 2244994945,
  "id_str": "2244994945",
  "name": "Twitter Dev",
  "screen_name": "TwitterDev",
  "location": "Internet",
  "description": "Your official source for Twitter Platform news, updates & events. Need technical help? Visit https://t.co/mGHnxZU8c1 ⌨️ #TapIntoTwitter",
  "url": "https://t.co/FGl7VOULyL",
  "entities": {
    "url": {
      "urls": [
        {
          "url": "https://t.co/FGl7VOULyL",
          "expanded_url": "https://developer.twitter.com/",
          "display_url": "developer.twitter.com",
          "indices": [
            0,
            23
          ]
        }
      ]
    },
    "description": {
      "urls": [
        {
          "url": "https://t.co/mGHnxZU8c1",
          "expanded_url": "https://twittercommunity.com/",
          "display_url": "twittercommunity.com",
          "indices": [
            93,
            116
          ]
        }
      ]
    }
  },
  "protected": false,
  "followers_count": 502084,
  "friends_count": 1472,
  "listed_count": 1514,
  "created_at": "Sat Dec 14 04:35:55 +0000 2013",
  "favourites_count": 2203,
  "utc_offset": null,
  "time_zone": null,
  "geo_enabled": true,
  "verified": true,
  "statuses_count": 3393,
  "lang": "en",
  "status": {
    "created_at": "Tue May 14 17:54:29 +0000 2019",
    "id": 1128357932238823424,
    "id_str": "1128357932238823424",
    "text": "We’ll release the first Labs endpoints to all eligible developers in the coming weeks. If you want to participate,… https://t.co/8q8sj87D5a",
    "truncated": true,
    "entities": {
      "hashtags": [],
      "symbols": [],
      "user_mentions": [],
      "urls": [
        {
          "url": "https://t.co/8q8sj87D5a",
          "expanded_url": "https://twitter.com/i/web/status/1128357932238823424",
          "display_url": "twitter.com/i/web/status/1…",
          "indices": [
            116,
            139
          ]
        }
      ]
    },
    "source": "<a href="https://mobile.twitter.com" rel="nofollow">Twitter Web App</a>",
    "in_reply_to_status_id": 1128357931026501633,
    "in_reply_to_status_id_str": "1128357931026501633",
    "in_reply_to_user_id": 2244994945,
    "in_reply_to_user_id_str": "2244994945",
    "in_reply_to_screen_name": "TwitterDev",
    "geo": null,
    "coordinates": null,
    "place": null,
    "contributors": null,
    "is_quote_status": false,
    "retweet_count": 13,
    "favorite_count": 41,
    "favorited": false,
    "retweeted": false,
    "possibly_sensitive": false,
    "lang": "en"
  },
  "contributors_enabled": false,
  "is_translator": false,
  "is_translation_enabled": null,
  "profile_background_color": "null",
  "profile_background_image_url": "null",
  "profile_background_image_url_https": "null",
  "profile_background_tile": null,
  "profile_image_url": "null",
  "profile_image_url_https": "https://pbs.twimg.com/profile_images/880136122604507136/xHrnqf1T_normal.jpg",
  "profile_banner_url": "https://pbs.twimg.com/profile_banners/2244994945/1498675817",
  "profile_link_color": "null",
  "profile_sidebar_border_color": "null",
  "profile_sidebar_fill_color": "null",
  "profile_text_color": "null",
  "profile_use_background_image": false,
  "has_extended_profile": null,
  "default_profile": false,
  "default_profile_image": false,
  "following": false,
  "follow_request_sent": false,
  "notifications": false,
  "muting": true,
  "translator_type": "null"
}