Social Intelligence

Community creator profile

Changed on

Ecosystem-wide profile for one creator by TikTok handle: name, avatar, TikTok URL, region, content categories, and windowed performance (GMV, average views, shop posts, engagement rate, followers).

This is the community view — what the creator does across all brands, which is the only view that exists for creators you have never worked with. For their history with your shop, use the CRM endpoints.

get/social-intelligence/creators/{handle}

Request

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/social-intelligence/creators/{handle}
  • Auth
    API key in header x-api-key and API key in header x-shop-id

Path parameters

handlestring required

Query parameters

window_daysinteger

Metric window in days, counted back from the creator's most recent shop post rather than from now — the same anchor /brands and /videos use, and echoed back as windowEnd. Only 1, 7, 28, 30, 90 are backed by data; anything else falls back to 28. The window is echoed back as windowDays.

Response

Successful Response

idstring required

FastMoss creator uid.

handlestring required
namestring required
avatarUrlstring required
tiktokUrlstring required
regionstring required
windowDaysinteger required

The window the figures were computed over.

windowEndstring nullable

ISO instant the window closes on: the creator's most recent shop post, not the time of the request. windowDays counts back from here, so a creator who last posted a month ago still reports their latest activity rather than an empty week. Null when we hold no dated video for them, in which case performance covers their whole history rather than a window.

categoriesL1string[]

Changes

    • breaking

      the response's body type changed from no type to object for status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status