---
title: "Community-wide creator directory"
method: GET
path: "/social-intelligence/creators"
tags: ["Social Intelligence"]
---

# Community-wide creator directory

`GET /social-intelligence/creators`

Every creator tracked in your region's TikTok Shop ecosystem — not just your affiliates. Each row carries the profile (handle, name, avatar, follower count, content categories) and windowed performance (GMV, average views, shop posts, engagement rate) over a 1-, 7- or 28-day window.

`isMyAffiliate` marks creators already in your CRM; set `hide_my_affiliates=true` to return only new prospects. Results are capped at 1000 rows — `capped: true` with `totalMatching` above that means you should narrow with `search` / `category` before paging.

## Query parameters

- `page` integer
- `page_size` integer
- `search` string, nullable
- `category` string, nullable
- `subcategory` string, nullable
- `sort_by` string, nullable — gmv, avgViews, shopPosts, engagement, followers
- `sort_order` string
- `window_days` integer — Metric window in days. Only 1, 7, 28 are backed by data; anything else falls back to 28. The window is echoed back as `windowDays`.
- `hide_my_affiliates` boolean — Exclude creators already affiliated with your shop.

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) · [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/reacherapp/reacher-data-api/revisions/5eefff009b5b/schema)