---
title: "Get creator detail"
method: GET
path: "/creators/{creator_handle}"
tags: ["Creators"]
---

# Get creator detail

`GET /creators/{creator_handle}`

Get detailed information for a single creator, including groups, products, and latest 10 videos (for full video list, use POST /creators/{creator_handle}/videos).

## Path parameters

- `creator_handle` string, required

## Response `200`

Successful Response

- CreatorDetailResponse
  - `data` CreatorListItem, required
    - `creator_handle` string, nullable
    - `follower_count` integer, nullable — DB: follower_num
    - `status` string, nullable — Display status from rev_status_mapping()
    - `shop_gmv` number, nullable — Lifetime shop-specific GMV. DB: crm_creators.gmv
    - `overall_gmv` number, nullable — Overall GMV from regional creator table. DB: Creator.gmv_num
    - `creator_level` string, nullable — GMV tier L0–L7, using the same thresholds as the dashboard's 'Creators by Level' chart (derived from overall_gmv: L0=$0, L1<$5k, L2<$25k, L3<$60k, L4<$150k, L5<$400k, L6<$1.0M, L7≥$1.0M). Null when overall GMV is unavailable for the creator.
    - `overall_fulfillment_rate` number, nullable — Overall fulfillment rate from regional creator table
    - `shop_units_sold` integer, nullable — DB: item_sold
    - `shop_video_count` integer, nullable — DB: video_num
    - `video_views` integer, nullable — DB: content_video_views
    - `sample_received` integer, nullable — DB: sample_received_num
    - `commission_rate` number, nullable
    - `est_commission` number, nullable — DB: estimate_commission
    - `fulfillment_rate` number, nullable — Shop-specific fulfillment rate from crm_creators
    - `tags` string[], nullable
    - `product_id` string, nullable
    - `product_title` string, nullable
    - `updated_at` string, nullable
    - `created_at` string, nullable
  - `groups` CreatorGroupItem[]
    - `group_id` string, required
    - `group_name` string, required
  - `products` CreatorProductItem[]
    - `product_id` string, required
    - `product_title` string, nullable
    - `commission_rate` number, nullable
    - `shop_units_sold` integer, nullable
    - `shop_gmv` number, nullable
    - `status` string, nullable
  - `videos` VideoItem[]
    - `video_id` string, required
    - `creator_id` string, nullable — Stable TikTok creator id for the video's author.
    - `title` string, nullable
    - `video_url` string, nullable — Thumbnail/preview image URL for the video (not the watch page).
    - `tiktok_url` string, nullable — Canonical TikTok video permalink (the watch page): https://www.tiktok.com/@<handle>/video/<id>.
    - `creator_handle` string, nullable
    - `product_id` string, nullable
    - `product_name` string, nullable
    - `views` integer, nullable
    - `like_count` integer, nullable
    - `comment_count` integer, nullable
    - `share_count` integer, nullable
    - `units_sold` integer, nullable
    - `video_gmv` number, nullable
    - `posted_date` string, nullable
  - `currency` string, required

## 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/d4fe3e380424/schema)