Skip to main content
GET
Retrieve TikTok LikeShop media

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

brand_id
integer
required

The Dash Social assigned ID of the brand.

Required range: x >= 0

Query Parameters

sort
enum<string>

Sort by field. "-" for descending.

Available options:
PUBLISHED_AT,
CREATED,
UPDATED,
ORDER,
VISITS,
ADDED,
POSTED,
CLICKS,
LIKESHOP_CLICKS,
PERFORMANCE,
VIDEO_VIEWS,
AVERAGE_VIDEO_WATCH_TIME,
INSTAGRAM_EFFECTIVENESS,
INSTAGRAM_REACH,
INSTAGRAM_ENGAGEMENT,
INSTAGRAM_ORGANIC_COMMENTS,
INSTAGRAM_PAID_COMMENTS,
INSTAGRAM_TOTAL_COMMENTS,
INSTAGRAM_ENGAGEMENT_RATE,
INSTAGRAM_ENGAGEMENT_RATE_VIEWS,
INSTAGRAM_ORGANIC_IMPRESSIONS,
INSTAGRAM_PAID_IMPRESSIONS,
INSTAGRAM_TOTAL_IMPRESSIONS,
INSTAGRAM_ORGANIC_LIKES,
INSTAGRAM_PAID_LIKES,
INSTAGRAM_TOTAL_LIKES,
INSTAGRAM_SAVES,
INSTAGRAM_TOTAL_ENGAGEMENTS,
INSTAGRAM_PAID_TOTAL_ENGAGEMENTS,
INSTAGRAM_SUM_TOTAL_ENGAGEMENTS,
INSTAGRAM_VIDEO_VIEWS,
INSTAGRAM_PAID_VIDEO_VIEWS,
INSTAGRAM_TOTAL_VIDEO_VIEWS,
INSTAGRAM_PAID_ENGAGEMENT_RATE,
INSTAGRAM_TOTAL_WATCH_TIME,
INSTAGRAM_STORY_REACH,
INSTAGRAM_STORY_IMPRESSIONS,
INSTAGRAM_STORY_SWIPE_UPS,
INSTAGRAM_STORY_REPLIES,
INSTAGRAM_STORY_EXIT_RATE,
PINTEREST_CLICKS,
PINTEREST_CLOSEUPS,
PINTEREST_COMMENTS,
PINTEREST_ENGAGEMENT,
PINTEREST_IMPRESSIONS,
PINTEREST_SAVES,
PINTEREST_VIDEO_VIEWS,
PINTEREST_AVERAGE_VIDEO_WATCH_TIME,
PINTEREST_ENGAGEMENTS,
DATE,
INSTAGRAM_STORY_FRAME_REACH,
INSTAGRAM_STORY_FRAME_IMPRESSIONS,
INSTAGRAM_STORY_FRAME_COMPLETION_RATE,
INSTAGRAM_STORY_FRAME_EXITS,
INSTAGRAM_STORY_FRAME_EXIT_RATE,
INSTAGRAM_STORY_FRAME_SWIPE_UPS,
INSTAGRAM_STORY_FRAME_REPLIES,
INSTAGRAM_STORY_FRAME_TAPS_BACK,
INSTAGRAM_STORY_FRAME_TAPS_FORWARD,
FACEBOOK_PHOTO_VIEW_CLICKS,
FACEBOOK_POST_CLICKS,
FACEBOOK_COMMENTS,
FACEBOOK_REACH,
FACEBOOK_EFFECTIVENESS,
FACEBOOK_REACTIONS,
FACEBOOK_ENGAGEMENT_RATE,
FACEBOOK_ENGAGEMENT_RATE_PUBLIC,
FACEBOOK_SHARES,
FACEBOOK_IMPRESSIONS,
FACEBOOK_TOTAL_ENGAGEMENTS,
FACEBOOK_TOTAL_ENGAGEMENTS_PUBLIC,
FACEBOOK_LINK_CLICKS,
FACEBOOK_VIDEO_COMPLETE_VIEWS,
FACEBOOK_OTHER_CLICKS,
FACEBOOK_VIDEO_VIEWS,
FACEBOOK_REELS_POST_VIDEO_VIEW_TIME,
FACEBOOK_REELS_POST_IMPRESSIONS_UNIQUE,
TWITTER_ENGAGEMENT_RATE,
TWITTER_IMPRESSIONS,
TWITTER_URL_CLICKS,
TWITTER_USER_PROFILE_CLICKS,
TWITTER_QUOTE_TWEETS,
TWITTER_REPLIES,
TWITTER_RETWEETS,
TWITTER_TOTAL_ENGAGEMENTS,
TWITTER_TOTAL_RETWEETS,
TWITTER_FOLLOWS,
TWITTER_VIDEO_VIEWS,
TIKTOK_REACH,
TIKTOK_AVERAGE_TIME_WATCHED,
TIKTOK_AVERAGE_COMPLETION_RATE,
TIKTOK_COMMENTS,
TIKTOK_IMPRESSIONS_SEARCH_RATE,
TIKTOK_FULL_VIDEO_WATCHED_RATE,
TIKTOK_SHARES,
TIKTOK_ENGAGEMENT_RATE,
TIKTOK_ENTERTAINMENT_SCORE,
TIKTOK_IMPRESSIONS_SOUND_RATE,
TIKTOK_IMPRESSIONS_FOLLOW_RATE,
TIKTOK_TOTAL_ENGAGEMENTS,
TIKTOK_IMPRESSIONS_FOR_YOU_RATE,
TIKTOK_TOTAL_TIME_WATCHED,
TIKTOK_IMPRESSIONS_HASHTAG_RATE,
TIKTOK_DURATION,
TIKTOK_LIKES,
TIKTOK_VIEWS,
TIKTOK_IMPRESSIONS_PERSONAL_PROFILE_RATE,
YOUTUBE_AVG_VIEW_PERCENTAGE,
YOUTUBE_AVG_VIEW_DURATION,
YOUTUBE_CARD_IMPRESSIONS,
YOUTUBE_CARD_CLICKS,
YOUTUBE_CARD_CLICK_RATE,
YOUTUBE_CARD_TEASER_CLICKS,
YOUTUBE_CARD_TEASER_CLICK_RATE,
YOUTUBE_CARD_TEASER_IMPRESSIONS,
YOUTUBE_COMMENTS,
YOUTUBE_DISLIKES,
YOUTUBE_LIKES,
YOUTUBE_PREMIUM_VIEWS,
YOUTUBE_EST_PREMIUM_SECONDS_WATCHED,
YOUTUBE_SHARES,
YOUTUBE_SUBSCRIBERS,
YOUTUBE_ENGAGEMENTS,
YOUTUBE_VIDEOS_ADDED_TO_PLAYLIST,
YOUTUBE_VIEWS,
YOUTUBE_EST_SECONDS_WATCHED,
LINKEDIN_CLICK_THROUGH_RATE,
LINKEDIN_CLICKS,
LINKEDIN_COMMENTS,
LINKEDIN_ENGAGEMENTS,
LINKEDIN_ENGAGEMENT_RATE,
LINKEDIN_IMPRESSIONS,
LINKEDIN_LIKES,
LINKEDIN_SHARES,
LINKEDIN_UNIQUE_IMPRESSIONS,
LINKEDIN_VIDEO_ANALYTICS_VIDEO_VIEWS,
LINKEDIN_VIDEO_ANALYTICS_TIME_WATCHED_FOR_VIEWS,
THREADS_ENGAGEMENTS,
THREADS_ENGAGEMENT_RATE,
THREADS_LIKES,
THREADS_QUOTES,
THREADS_REPLIES,
THREADS_REPOSTS,
THREADS_REPOSTS_AND_QUOTES,
THREADS_SHARES,
THREADS_VIEWS,
SNAPCHAT_AVG_VIEW_TIME_SECONDS,
SNAPCHAT_COMPLETES,
SNAPCHAT_ENGAGEMENT_RATE,
SNAPCHAT_ENGAGEMENTS,
SNAPCHAT_FAVORITES,
SNAPCHAT_INTERACTIONS,
SNAPCHAT_REPLIES,
SNAPCHAT_SHARES,
SNAPCHAT_SWIPE_DOWNS,
SNAPCHAT_SWIPE_UPS,
SNAPCHAT_UNIQUE_SESSIONS,
SNAPCHAT_VIEW_TIME_SECONDS,
SNAPCHAT_VIEWERS,
SNAPCHAT_VIEWS,
-PUBLISHED_AT,
-CREATED,
-UPDATED,
-ORDER,
-VISITS,
-ADDED,
-POSTED,
-CLICKS,
-LIKESHOP_CLICKS,
-PERFORMANCE,
-VIDEO_VIEWS,
-AVERAGE_VIDEO_WATCH_TIME,
-INSTAGRAM_EFFECTIVENESS,
-INSTAGRAM_REACH,
-INSTAGRAM_ENGAGEMENT,
-INSTAGRAM_ORGANIC_COMMENTS,
-INSTAGRAM_PAID_COMMENTS,
-INSTAGRAM_TOTAL_COMMENTS,
-INSTAGRAM_ENGAGEMENT_RATE,
-INSTAGRAM_ENGAGEMENT_RATE_VIEWS,
-INSTAGRAM_ORGANIC_IMPRESSIONS,
-INSTAGRAM_PAID_IMPRESSIONS,
-INSTAGRAM_TOTAL_IMPRESSIONS,
-INSTAGRAM_ORGANIC_LIKES,
-INSTAGRAM_PAID_LIKES,
-INSTAGRAM_TOTAL_LIKES,
-INSTAGRAM_SAVES,
-INSTAGRAM_TOTAL_ENGAGEMENTS,
-INSTAGRAM_PAID_TOTAL_ENGAGEMENTS,
-INSTAGRAM_SUM_TOTAL_ENGAGEMENTS,
-INSTAGRAM_VIDEO_VIEWS,
-INSTAGRAM_PAID_VIDEO_VIEWS,
-INSTAGRAM_TOTAL_VIDEO_VIEWS,
-INSTAGRAM_PAID_ENGAGEMENT_RATE,
-INSTAGRAM_TOTAL_WATCH_TIME,
-INSTAGRAM_STORY_REACH,
-INSTAGRAM_STORY_IMPRESSIONS,
-INSTAGRAM_STORY_SWIPE_UPS,
-INSTAGRAM_STORY_REPLIES,
-INSTAGRAM_STORY_EXIT_RATE,
-PINTEREST_CLICKS,
-PINTEREST_CLOSEUPS,
-PINTEREST_COMMENTS,
-PINTEREST_ENGAGEMENT,
-PINTEREST_IMPRESSIONS,
-PINTEREST_SAVES,
-PINTEREST_VIDEO_VIEWS,
-PINTEREST_AVERAGE_VIDEO_WATCH_TIME,
-PINTEREST_ENGAGEMENTS,
-DATE,
-INSTAGRAM_STORY_FRAME_REACH,
-INSTAGRAM_STORY_FRAME_IMPRESSIONS,
-INSTAGRAM_STORY_FRAME_COMPLETION_RATE,
-INSTAGRAM_STORY_FRAME_EXITS,
-INSTAGRAM_STORY_FRAME_EXIT_RATE,
-INSTAGRAM_STORY_FRAME_SWIPE_UPS,
-INSTAGRAM_STORY_FRAME_REPLIES,
-INSTAGRAM_STORY_FRAME_TAPS_BACK,
-INSTAGRAM_STORY_FRAME_TAPS_FORWARD,
-FACEBOOK_PHOTO_VIEW_CLICKS,
-FACEBOOK_POST_CLICKS,
-FACEBOOK_COMMENTS,
-FACEBOOK_REACH,
-FACEBOOK_EFFECTIVENESS,
-FACEBOOK_REACTIONS,
-FACEBOOK_ENGAGEMENT_RATE,
-FACEBOOK_ENGAGEMENT_RATE_PUBLIC,
-FACEBOOK_SHARES,
-FACEBOOK_IMPRESSIONS,
-FACEBOOK_TOTAL_ENGAGEMENTS,
-FACEBOOK_TOTAL_ENGAGEMENTS_PUBLIC,
-FACEBOOK_LINK_CLICKS,
-FACEBOOK_VIDEO_COMPLETE_VIEWS,
-FACEBOOK_OTHER_CLICKS,
-FACEBOOK_VIDEO_VIEWS,
-FACEBOOK_REELS_POST_VIDEO_VIEW_TIME,
-FACEBOOK_REELS_POST_IMPRESSIONS_UNIQUE,
-TWITTER_ENGAGEMENT_RATE,
-TWITTER_IMPRESSIONS,
-TWITTER_URL_CLICKS,
-TWITTER_USER_PROFILE_CLICKS,
-TWITTER_QUOTE_TWEETS,
-TWITTER_REPLIES,
-TWITTER_RETWEETS,
-TWITTER_TOTAL_ENGAGEMENTS,
-TWITTER_TOTAL_RETWEETS,
-TWITTER_FOLLOWS,
-TWITTER_VIDEO_VIEWS,
-TIKTOK_REACH,
-TIKTOK_AVERAGE_TIME_WATCHED,
-TIKTOK_AVERAGE_COMPLETION_RATE,
-TIKTOK_COMMENTS,
-TIKTOK_IMPRESSIONS_SEARCH_RATE,
-TIKTOK_FULL_VIDEO_WATCHED_RATE,
-TIKTOK_SHARES,
-TIKTOK_ENGAGEMENT_RATE,
-TIKTOK_ENTERTAINMENT_SCORE,
-TIKTOK_IMPRESSIONS_SOUND_RATE,
-TIKTOK_IMPRESSIONS_FOLLOW_RATE,
-TIKTOK_TOTAL_ENGAGEMENTS,
-TIKTOK_IMPRESSIONS_FOR_YOU_RATE,
-TIKTOK_TOTAL_TIME_WATCHED,
-TIKTOK_IMPRESSIONS_HASHTAG_RATE,
-TIKTOK_DURATION,
-TIKTOK_LIKES,
-TIKTOK_VIEWS,
-TIKTOK_IMPRESSIONS_PERSONAL_PROFILE_RATE,
-YOUTUBE_AVG_VIEW_PERCENTAGE,
-YOUTUBE_AVG_VIEW_DURATION,
-YOUTUBE_CARD_IMPRESSIONS,
-YOUTUBE_CARD_CLICKS,
-YOUTUBE_CARD_CLICK_RATE,
-YOUTUBE_CARD_TEASER_CLICKS,
-YOUTUBE_CARD_TEASER_CLICK_RATE,
-YOUTUBE_CARD_TEASER_IMPRESSIONS,
-YOUTUBE_COMMENTS,
-YOUTUBE_DISLIKES,
-YOUTUBE_LIKES,
-YOUTUBE_PREMIUM_VIEWS,
-YOUTUBE_EST_PREMIUM_SECONDS_WATCHED,
-YOUTUBE_SHARES,
-YOUTUBE_SUBSCRIBERS,
-YOUTUBE_ENGAGEMENTS,
-YOUTUBE_VIDEOS_ADDED_TO_PLAYLIST,
-YOUTUBE_VIEWS,
-YOUTUBE_EST_SECONDS_WATCHED,
-LINKEDIN_CLICK_THROUGH_RATE,
-LINKEDIN_CLICKS,
-LINKEDIN_COMMENTS,
-LINKEDIN_ENGAGEMENTS,
-LINKEDIN_ENGAGEMENT_RATE,
-LINKEDIN_IMPRESSIONS,
-LINKEDIN_LIKES,
-LINKEDIN_SHARES,
-LINKEDIN_UNIQUE_IMPRESSIONS,
-LINKEDIN_VIDEO_ANALYTICS_VIDEO_VIEWS,
-LINKEDIN_VIDEO_ANALYTICS_TIME_WATCHED_FOR_VIEWS,
-THREADS_ENGAGEMENTS,
-THREADS_ENGAGEMENT_RATE,
-THREADS_LIKES,
-THREADS_QUOTES,
-THREADS_REPLIES,
-THREADS_REPOSTS,
-THREADS_REPOSTS_AND_QUOTES,
-THREADS_SHARES,
-THREADS_VIEWS,
-SNAPCHAT_AVG_VIEW_TIME_SECONDS,
-SNAPCHAT_COMPLETES,
-SNAPCHAT_ENGAGEMENT_RATE,
-SNAPCHAT_ENGAGEMENTS,
-SNAPCHAT_FAVORITES,
-SNAPCHAT_INTERACTIONS,
-SNAPCHAT_REPLIES,
-SNAPCHAT_SHARES,
-SNAPCHAT_SWIPE_DOWNS,
-SNAPCHAT_SWIPE_UPS,
-SNAPCHAT_UNIQUE_SESSIONS,
-SNAPCHAT_VIEW_TIME_SECONDS,
-SNAPCHAT_VIEWERS,
-SNAPCHAT_VIEWS
limit
integer
default:100

Number of results to return in a single response.

Required range: 1 <= x <= 1000
offset
integer
default:0

The offset of the first result to be returned.

Required range: x >= 0
start_date
string | null

A formatted datetime string in UTC.

Pattern: ^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(Z|((\+|-)\d{2}:\d{2})))?$
Example:

"2019-12-01"

end_date
string | null

A formatted datetime string in UTC.

Pattern: ^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(Z|((\+|-)\d{2}:\d{2})))?$
Example:

"2019-12-12"

with_products_only
boolean
default:false

Only return media that have products.

Response

OK

data
object[]
paging
object