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. noradio
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=themattharris&perform_block=false

Example Response

{
  "name": "Matt Harris",
  "profile_sidebar_border_color": "C0DEED",
  "profile_sidebar_fill_color": "DDEEF6",
  "profile_background_tile": false,
  "profile_image_url": "http://a0.twimg.com/profile_images/554181350/matt_normal.jpg",
  "created_at": "Sat Feb 17 20:49:54 +0000 2007",
  "location": "SFO/LHR/YVR/JAX/IAD",
  "is_translator": false,
  "follow_request_sent": false,
  "id_str": "777925",
  "profile_link_color": "0084B4",
  "entities": {
    "url": {
      "urls": [
        {
          "expanded_url": null,
          "url": "http://www.themattharris.com",
          "indices": [
            0,
            28
          ],
          "display_url": null
        }
      ]
    },
    "description": {
      "urls": [

      ]
    }
  },
  "default_profile": true,
  "contributors_enabled": true,
  "url": "http://www.themattharris.com",
  "favourites_count": 213,
  "utc_offset": -28800,
  "id": 777925,
  "profile_image_url_https": "https://si0.twimg.com/profile_images/554181350/matt_normal.jpg",
  "profile_use_background_image": true,
  "listed_count": 303,
  "profile_text_color": "333333",
  "protected": false,
  "lang": "en",
  "followers_count": 7984,
  "time_zone": "Pacific Time (US & Canada)",
  "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png",
  "verified": false,
  "profile_background_color": "C0DEED",
  "notifications": false,
  "description": "Part of @twitter's Platform Services. Married to @cindyli. Kryptonite hurts me.",
  "geo_enabled": true,
  "statuses_count": 4492,
  "default_profile_image": false,
  "status": {
    "coordinates": null,
    "favorited": false,
    "created_at": "Tue Aug 28 00:11:59 +0000 2012",
    "truncated": false,
    "id_str": "240240276298420224",
    "entities": {
      "urls": [
        {
          "expanded_url": "https://twitter.com/rsarver/status/240224006807117828",
          "url": "https://t.co/DdTXEtcd",
          "indices": [
            71,
            92
          ],
          "display_url": "twitter.com/rsarver/status…"
        },
        {
          "expanded_url": "https://twitter.com/rsarver/status/240223841786404864",
          "url": "https://t.co/Pq8Sj0sl",
          "indices": [
            97,
            118
          ],
          "display_url": "twitter.com/rsarver/status…"
        }
      ],
      "hashtags": [

      ],
      "user_mentions": [
        {
          "name": "Heilemann",
          "id_str": "11656",
          "id": 11656,
          "indices": [
            1,
            11
          ],
          "screen_name": "Heilemann"
        },
        {
          "name": "Luke Dorny",
          "id_str": "12587",
          "id": 12587,
          "indices": [
            13,
            24
          ],
          "screen_name": "luxuryluke"
        },
        {
          "name": "Ryan Sarver",
          "id_str": "795649",
          "id": 795649,
          "indices": [
            27,
            35
          ],
          "screen_name": "rsarver"
        },
        {
          "name": "Jeremy Keith",
          "id_str": "11250",
          "id": 11250,
          "indices": [
            61,
            69
          ],
          "screen_name": "adactio"
        }
      ]
    },
    "in_reply_to_user_id_str": "11656",
    "text": ".@Heilemann, @luxuryluke - @rsarver has been clarifying with @adactio: https://t.co/DdTXEtcd and https://t.co/Pq8Sj0sl",
    "contributors": null,
    "retweet_count": 0,
    "id": 240240276298420224,
    "in_reply_to_status_id_str": "240226590703898624",
    "geo": null,
    "retweeted": false,
    "in_reply_to_user_id": 11656,
    "possibly_sensitive": false,
    "place": null,
    "possibly_sensitive_editable": true,
    "source": "Twitter for  iPhone",
    "in_reply_to_screen_name": "Heilemann",
    "in_reply_to_status_id": 240226590703898624
  },
  "friends_count": 430,
  "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png",
  "show_all_inline_media": false,
  "screen_name": "themattharris",
  "following": true
}

Was this document helpful?

Thank you

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?

Thank you for the feedback. Your comments will help us improve our documents in the future.