One creator's Creator Marketplace profile for the last 30 days
GET
/api/public/v1/tik_tok_shop/creators/{openId}/marketplaceConnectorAnswers empty results in the documented shape until the brand switches on this connection.
Operation id getTikTokShopCreatorMarketplace
Request
curl
curl "https://creator.growthdept.ai/api/public/v1/tik_tok_shop/creators/<openId>/marketplace" \
-H "Authorization: Bearer gdc_..."Parameters
| Name | In | Type | Notes |
|---|---|---|---|
| openId | path | string | required |
| organization_id | query | integer |
Responses
200Success
| Field | Type | Notes |
|---|---|---|
| creator | object | required |
| creator.avatarUrl | string, nullable | |
| creator.avgCommissionRate | integer, nullable | |
| creator.avgCommissionRateRange | object, nullable | |
| creator.avgCommissionRateRange.max | integer, nullable | |
| creator.avgCommissionRateRange.min | integer, nullable | |
| creator.avgEcLiveCommentCount | integer, nullable | |
| creator.avgEcLiveLikeCount | integer, nullable | |
| creator.avgEcLiveShareCount | integer, nullable | |
| creator.avgEcLiveViewCount | integer, nullable | |
| creator.avgEcVideoCommentCount | integer, nullable | |
| creator.avgEcVideoLikeCount | integer, nullable | |
| creator.avgEcVideoPlayCount | integer, nullable | |
| creator.avgEcVideoShareCount | integer, nullable | |
| creator.avgGmvPerBuyer | object, nullable | |
| creator.avgGmvPerBuyer.amount | string, nullable | |
| creator.avgGmvPerBuyer.currency | string, nullable | |
| creator.avgGmvPerBuyerRange | object, nullable | |
| creator.avgGmvPerBuyerRange.currency | string, nullable | |
| creator.avgGmvPerBuyerRange.formatted | string, nullable | |
| creator.avgGmvPerBuyerRange.max | string, nullable | |
| creator.avgGmvPerBuyerRange.min | string, nullable | |
| creator.bioDescription | string, nullable | |
| creator.brandCollaborationCount | integer, nullable | |
| creator.categoryGmvDistribution | array of object | |
| creator.categoryGmvDistribution[].[].categoryId | string, nullable | |
| creator.categoryGmvDistribution[].[].value | string, nullable | |
| creator.categoryIds | array of string | |
| creator.contentGmvDistribution | array of object | |
| creator.contentGmvDistribution[].[].contentType | string, nullable | |
| creator.contentGmvDistribution[].[].value | string, nullable | |
| creator.creatorProfile | object, nullable | |
| creator.creatorProfile.connect | object, nullable | |
| creator.creatorProfile.connect.isBlocked | boolean, nullable | |
| creator.creatorProfile.connect.isConnect | boolean, nullable | |
| creator.creatorProfile.connect.isPaired | boolean, nullable | |
| creator.creatorProfile.contactInfoAvailable | boolean, nullable | |
| creator.creatorProfile.creatorLevel | integer, nullable | |
| creator.creatorProfile.fulfillmentReviews | integer, nullable | |
| creator.creatorProfile.fulfillmentScore90d | string, nullable | |
| creator.creatorProfile.hasInvitedLast90Days | boolean, nullable | |
| creator.creatorProfile.isBlockedByShop | boolean, nullable | |
| creator.creatorProfile.isEligibleFlatFee | boolean, nullable | |
| creator.creatorProfile.isOfficialRecommend | boolean, nullable | |
| creator.creatorProfile.isRisingStar | boolean, nullable | |
| creator.creatorProfile.liveCommentCount30dMedian | integer, nullable | |
| creator.creatorProfile.liveEngagementRate30d | integer, nullable | |
| creator.creatorProfile.liveLikeCount30d | integer, nullable | |
| creator.creatorProfile.liveShareCount30dMedian | integer, nullable | |
| creator.creatorProfile.liveViewCount30dMedian | integer, nullable | |
| creator.creatorProfile.mcnName | string, nullable | |
| creator.creatorProfile.sampleScore | integer, nullable | |
| creator.creatorProfile.videoPlayCount30dMedian | integer, nullable | |
| creator.creatorProfile.videoPublishCount30dMedian | integer, nullable | |
| creator.creatorTrend | array of object | |
| creator.creatorTrend[].[].endTimestamp | integer, nullable | |
| creator.creatorTrend[].[].engagementRate | integer, nullable | |
| creator.creatorTrend[].[].follower | integer, nullable | |
| creator.creatorTrend[].[].gmv | object, nullable | |
| creator.creatorTrend[].[].gmv.amount | string, nullable | |
| creator.creatorTrend[].[].gmv.symbol | string, nullable | |
| creator.creatorTrend[].[].startTimestamp | integer, nullable | |
| creator.creatorTrend[].[].unitsSold | integer, nullable | |
| creator.ecLiveCount | integer, nullable | |
| creator.ecLiveEngagementRate | string, nullable | |
| creator.ecVideoCount | integer, nullable | |
| creator.ecVideoEngagementRate | string, nullable | |
| creator.followerAge | array of object | |
| creator.followerAge[].[].key | string | |
| creator.followerAge[].[].value | string, nullable | |
| creator.followerCount | integer, nullable | |
| creator.followerGender | array of object | |
| creator.followerGender[].[].key | string | |
| creator.followerGender[].[].value | string, nullable | |
| creator.followerLocation | array of object | |
| creator.followerLocation[].[].key | string | |
| creator.followerLocation[].[].value | string, nullable | |
| creator.gmv | object, nullable | |
| creator.gmv.amount | string, nullable | |
| creator.gmv.currency | string, nullable | |
| creator.gmvRange | object, nullable | |
| creator.gmvRange.currency | string, nullable | |
| creator.gmvRange.formatted | string, nullable | |
| creator.gmvRange.max | string, nullable | |
| creator.gmvRange.min | string, nullable | |
| creator.gpm | object, nullable | |
| creator.gpm.amount | string, nullable | |
| creator.gpm.currency | string, nullable | |
| creator.gpmRange | object, nullable | |
| creator.gpmRange.currency | string, nullable | |
| creator.gpmRange.formatted | string, nullable | |
| creator.gpmRange.max | string, nullable | |
| creator.gpmRange.min | string, nullable | |
| creator.liveGmv | object, nullable | |
| creator.liveGmv.amount | string, nullable | |
| creator.liveGmv.currency | string, nullable | |
| creator.liveGpm | object, nullable | |
| creator.liveGpm.amount | string, nullable | |
| creator.liveGpm.currency | string, nullable | |
| creator.liveGpmRange | object, nullable | |
| creator.liveGpmRange.currency | string, nullable | |
| creator.liveGpmRange.formatted | string, nullable | |
| creator.liveGpmRange.max | string, nullable | |
| creator.liveGpmRange.min | string, nullable | |
| creator.nickname | string, nullable | |
| creator.postRate | string, nullable | |
| creator.pps | string, nullable | |
| creator.productOriginalPriceRange | object, nullable | |
| creator.productOriginalPriceRange.currency | string, nullable | |
| creator.productOriginalPriceRange.formatted | string, nullable | |
| creator.productOriginalPriceRange.max | string, nullable | |
| creator.productOriginalPriceRange.min | string, nullable | |
| creator.profileTtUri | string, nullable | |
| creator.promotedProductNum | integer, nullable | |
| creator.rating | string, nullable | |
| creator.selectionRegion | string, nullable | |
| creator.topCollaboratedBrandIds | array of string | |
| creator.unitsSold | integer, nullable | |
| creator.unitsSoldRange | object, nullable | |
| creator.unitsSoldRange.formatted | string, nullable | |
| creator.unitsSoldRange.max | integer, nullable | |
| creator.unitsSoldRange.min | integer, nullable | |
| creator.username | string, nullable | |
| creator.videoGmv | object, nullable | |
| creator.videoGmv.amount | string, nullable | |
| creator.videoGmv.currency | string, nullable | |
| creator.videoGpm | object, nullable | |
| creator.videoGpm.amount | string, nullable | |
| creator.videoGpm.currency | string, nullable | |
| creator.videoGpmRange | object, nullable | |
| creator.videoGpmRange.currency | string, nullable | |
| creator.videoGpmRange.formatted | string, nullable | |
| creator.videoGpmRange.max | string, nullable | |
| creator.videoGpmRange.min | string, nullable | |
| openId | string | required |
| secUid | string, nullable | required |
Example
{
"creator": {
"avatarUrl": "https://example.com/p/1",
"avgCommissionRate": 3,
"avgCommissionRateRange": {
"max": 3,
"min": 3
},
"avgEcLiveCommentCount": 3,
"avgEcLiveLikeCount": 3,
"avgEcLiveShareCount": 3,
"avgEcLiveViewCount": 3,
"avgEcVideoCommentCount": 3,
"avgEcVideoLikeCount": 3,
"avgEcVideoPlayCount": 3,
"avgEcVideoShareCount": 3,
"avgGmvPerBuyer": {
"amount": "string",
"currency": "usd"
},
"avgGmvPerBuyerRange": {
"currency": "usd",
"formatted": "string",
"max": "string",
"min": "string"
},
"bioDescription": "string",
"brandCollaborationCount": 3,
"categoryGmvDistribution": [
{
"categoryId": "string",
"value": "string"
}
],
"categoryIds": [
"string"
],
"contentGmvDistribution": [
{
"contentType": "string",
"value": "string"
}
],
"creatorProfile": {
"connect": {
"isBlocked": true,
"isConnect": true,
"isPaired": true
},
"contactInfoAvailable": true,
"creatorLevel": 3,
"fulfillmentReviews": 3,
"fulfillmentScore90d": "string",
"hasInvitedLast90Days": true,
"isBlockedByShop": true,
"isEligibleFlatFee": true,
"isOfficialRecommend": true,
"isRisingStar": true,
"liveCommentCount30dMedian": 3,
"liveEngagementRate30d": 3,
"liveLikeCount30d": 3,
"liveShareCount30dMedian": 3,
"liveViewCount30dMedian": 3,
"mcnName": "Example name",
"sampleScore": 3,
"videoPlayCount30dMedian": 3,
"videoPublishCount30dMedian": 3
},
"creatorTrend": [
{
"endTimestamp": 3,
"engagementRate": 3,
"follower": 3,
"gmv": {
"amount": "string",
"symbol": "string"
},
"startTimestamp": 3,
"unitsSold": 3
}
],
"ecLiveCount": 3,
"ecLiveEngagementRate": "string",
"ecVideoCount": 3,
"ecVideoEngagementRate": "string",
"followerAge": [
{
"key": "string",
"value": "string"
}
],
"followerCount": 3,
"followerGender": [
{
"key": "string",
"value": "string"
}
],
"followerLocation": [
{
"key": "string",
"value": "string"
}
],
"gmv": {
"amount": "string",
"currency": "usd"
},
"gmvRange": {
"currency": "usd",
"formatted": "string",
"max": "string",
"min": "string"
},
"gpm": {
"amount": "string",
"currency": "usd"
},
"gpmRange": {
"currency": "usd",
"formatted": "string",
"max": "string",
"min": "string"
},
"liveGmv": {
"amount": "string",
"currency": "usd"
},
"liveGpm": {
"amount": "string",
"currency": "usd"
},
"liveGpmRange": {
"currency": "usd",
"formatted": "string",
"max": "string",
"min": "string"
},
"nickname": "Example name",
"postRate": "string",
"pps": "string",
"productOriginalPriceRange": {
"currency": "usd",
"formatted": "string",
"max": "string",
"min": "string"
},
"profileTtUri": "string",
"promotedProductNum": 3,
"rating": "string",
"selectionRegion": "string",
"topCollaboratedBrandIds": [
"string"
],
"unitsSold": 3,
"unitsSoldRange": {
"formatted": "string",
"max": 3,
"min": 3
},
"username": "Example name",
"videoGmv": {
"amount": "string",
"currency": "usd"
},
"videoGpm": {
"amount": "string",
"currency": "usd"
},
"videoGpmRange": {
"currency": "usd",
"formatted": "string",
"max": "string",
"min": "string"
}
},
"openId": "string",
"secUid": "string"
}Errors: 400401403404422429502with an error and usually a message. See errors.
Example values are made up from each field's type and name.