Social Actions API

Verify User Retweeted a Tweet

This endpoint provides a convenient way to check if a user retweeted a tweet identified by tweet_id. This will recursively retrieve all users who recently retweeted a tweet and check if the user_id is present among the retrieved users.

get/twitter/tweets/{tweet_id}/retweeted_by/{user_id}

Path parameters

tweet_idstring required

The numeric ID of the target tweet. When using languages where the id value exceeds the default Integer type limit (e.g., JavaScript), you should store id as a String. Use the id_str property returned by the API for these values.

user_idstring required

The numeric ID of the user. When using languages where the id value exceeds the default Integer type limit (e.g., JavaScript), you should store id as a String. Use the id_str property returned by the API for these values.

Response

Request succeeded

statusstring required
source_user_idstring required

The string representation of the unique identifier for User.

target_tweet_idstring required

The string representation of the unique identifier for the Tweet being retweeted.

is_retweetedboolean required

Indicates whether user identified by source_user_id has retweeted the Tweet= identified by target_tweet_id.

retweeters_checked_countinteger required

Deprecated. Currently returns 'null'

Example response

{
  "source_user_id": "44196397",
  "target_tweet_id": "1319287761048723458"
}

Changes

Changed in 1 of the 6 revisions of this API.16

  • 73745ce76c4916See the full diff
    • the response's body type/format changed from / to object/ for status 200

      response-body-type-changed

    • removed UserRetweetedStatus ErrorResponse from the response body oneOf list for the response status 200

      response-body-one-of-removed

    • added the required property is_retweeted to the response with the 200 status

      response-required-property-added

    • added the required property retweeters_checked_count to the response with the 200 status

      response-required-property-added

    • added the required property source_user_id to the response with the 200 status

      response-required-property-added

    • added the required property status to the response with the 200 status

      response-required-property-added

    • added the required property target_tweet_id to the response with the 200 status

      response-required-property-added

    This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog