Creators

Compare creators over a window

One row per creator: followers, posts published in the window, posts per week, total views/likes/comments/shares/saves, interaction rate and engagement rate. Instagram reports neither shares nor saves, so those come back null — null is not zero, and summing across platforms is wrong.

get/api/v1/creators/performance

Request

  • Base URL: https://api.adsmom.com
  • URL: https://api.adsmom.com/api/v1/creators/performance
  • Auth: HTTP bearer

Query parameters

platform'tiktok-social' | 'instagram-social'

Filter to one platform. Omit for both.

idsstring

Restrict to specific creators (comma-separated id tokens). Omit for all tracked creators.

date_fromstring

Window start (ISO 8601).

date_tostring

Window end (ISO 8601).

sort_by'views' | 'likes' | 'comments' | 'shares' | 'saves' | 'interaction_rate'

Ranking metric, descending.

cursorstring

Opaque pagination cursor. Pass back next_cursor.

limitnumber

Response

gidstring required

Canonical global id. Use id_token in path params.

id_tokenstring required

Slash-free id token for use in URL path segments.

platform'tiktok-social' | 'instagram-social' required
handlestring nullable required
namestring nullable required
follower_countnumber nullable required
posts_in_rangenumber required

Posts published inside the requested window.

posts_per_weeknumber required

Average posts per week over the window.

viewsnumber nullable required
likesnumber nullable required
commentsnumber nullable required
sharesnumber nullable required

Null on Instagram — the platform does not report shares.

savesnumber nullable required

Null on Instagram — the platform does not report saves.

interaction_ratenumber nullable required

Interactions as a percentage of views. Instagram has a smaller numerator (no shares or saves), so the two platforms are not directly comparable.

engagement_ratenumber nullable required

Average interactions per post as a percentage of followers. Null when the follower count is unknown.

Changes

No recorded changes to this operation across all 1 revision of this API.