Skip to main content

What it does

Returns a paginated list of videos reposted by a TikTok user. Note: Users may have their reposts set to private, in which case an empty list will be returned.

Tool details

FieldValue
Tool nametiktok_get_user_reposts
PlatformTikTok
REST endpointGET /v1/tiktok/users/{username}/reposts
Result typeCollection tool

Parameters

ParameterTypeRequiredDescription
usernamestringYesTikTok username (with or without @ symbol)
countintegerNoNumber of videos to fetch (maximum: 30) Default: 30.
cursorstringNoPagination cursor Default: 0.
orderstringNoSort order: newest (default), popular, or oldest Default: newest. Allowed values: newest, popular, oldest.
projection_presetstringNoDefaults to minimal. Allowed values: full, minimal, identity, engagement, content.
data_fieldsstring[]NoAdds top-level keys from data on top of the selected projection_preset.
item_fieldsstring[]NoAdds keys from data.orderedItems[] on top of the selected projection_preset.

Example

{
  "name": "tiktok_get_user_reposts",
  "arguments": {
    "username": "khaby.lame",
    "count": 30,
    "projection_preset": "minimal",
    "data_fields": [
      "orderedItems",
      "nextCursor",
      "cursor",
      "itemCount"
    ],
    "item_fields": [
      "entityId",
      "published",
      "content",
      "url",
      "viewCount"
    ]
  }
}

Available data fields

  • @context
  • type
  • partOf
  • totalItems
  • cursor
  • nextCursor
  • next
  • itemCount
  • orderedItems

Available item fields

  • type
  • id
  • url
  • entityId
  • content
  • published
  • duration
  • viewCount
  • likeCount
  • commentCount
  • repostCount
  • shareCount
  • saveCount
  • language
  • isSponsored
  • location
  • tag
  • attributedTo
  • attachment
  • image
  • preview
  • audio

Response notes

Successful calls return a JSON object with a top-level data field and, when available, metadata.creditsUsed and metadata.creditsRemaining. See response format, pagination, and credits.