Skip to main content
GET
/
v1
/
tiktok
/
shop-creator
/
sales
cURL
curl --request GET \
  --url 'https://api.keyapi.ai/v1/tiktok/shop-creator/sales?creator_oecuid=7494008088472553296&region=US' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'
{
  "code": 0,
  "message": "success",
  "data": {
    "creator_oecuid": {
      "value": "7494008088472553296",
      "is_authorized": true,
      "status": 0
    },
    "selection_region": {
      "value": "US",
      "is_authorized": true,
      "status": 0
    },
    "product_cnt": {
      "is_authorized": true,
      "status": 0
    },
    "ec_video_gpm_reference": {
      "value": true,
      "is_authorized": true,
      "status": 0
    },
    "ec_live_gpm_reference": {
      "value": true,
      "is_authorized": true,
      "status": 0
    },
    "ec_live_avg_comment_cnt": {
      "value": "0",
      "is_authorized": true,
      "status": 0
    },
    "ec_live_gpm": {
      "value": {
        "minimal": "0",
        "maximum": "0",
        "symbol": "$",
        "minimal_format": "$0",
        "maximum_format": "$0"
      },
      "is_authorized": true,
      "status": 0
    },
    "ec_video_gpm": {
      "value": {
        "minimal": "4.78",
        "maximum": "4.78",
        "symbol": "$",
        "minimal_format": "$4.78",
        "maximum_format": "$4.78"
      },
      "is_authorized": true,
      "status": 0
    },
    "units_sold": {
      "value": "4",
      "is_authorized": true,
      "status": 0
    },
    "med_gmv_revenue": {
      "value": {
        "value": "296.99",
        "symbol": "$",
        "format": "$296.99"
      },
      "is_authorized": true,
      "status": 0
    },
    "industry_groups": {
      "value": [
        {
          "key": "601739",
          "value": "1.0000",
          "name": "Phones & Electronics"
        }
      ],
      "is_authorized": true,
      "status": 0
    },
    "content_groups": {
      "value": [
        {
          "key": "video_gmv",
          "value": "1.0000"
        }
      ],
      "is_authorized": true,
      "status": 0
    },
    "product_price_range": {
      "value": "$34.99 - $99.99",
      "is_authorized": true,
      "status": 0
    },
    "sales_performance_end_time": {
      "value": "1768608000",
      "is_authorized": true,
      "status": 0
    },
    "gpm": {
      "value": {
        "value": "4.78",
        "symbol": "$",
        "format": "$4.78"
      },
      "is_authorized": true,
      "status": 0
    },
    "video_engagement": {
      "value": 708,
      "is_authorized": true,
      "status": 0
    },
    "video_gmv": {
      "value": {
        "value": "296.99",
        "symbol": "$",
        "format": "$296.99"
      },
      "is_authorized": true,
      "status": 0
    },
    "live_gmv": {
      "value": {
        "value": "0",
        "symbol": "$",
        "format": "$0"
      },
      "is_authorized": true,
      "status": 0
    },
    "ec_video_engagement": {
      "value": 192,
      "is_authorized": true,
      "status": 0
    },
    "video_avg_view_cnt": {
      "is_authorized": true,
      "status": 0
    },
    "video_play_cnt_med": {
      "value": "2570",
      "is_authorized": true,
      "status": 0
    },
    "ec_video_play_cnt_med": {
      "value": "57713",
      "is_authorized": true,
      "status": 0
    },
    "avg_revenue_per_buyer": {
      "value": {
        "value": "74.25",
        "symbol": "$",
        "format": "$74.25"
      },
      "is_authorized": true,
      "status": 0
    },
    "collaborated_brands_num": {
      "value": 2,
      "is_authorized": true,
      "status": 0
    },
    "gpm_reference": {
      "value": true,
      "is_authorized": true,
      "status": 0
    },
    "ec_live_engagement": {
      "value": 0,
      "is_authorized": true,
      "status": 0
    },
    "live_engagement": {
      "value": 5,
      "is_authorized": true,
      "status": 0
    },
    "med_gmv_revenue_range": {
      "value": "$0-$5k",
      "is_authorized": true,
      "status": 0
    },
    "gpm_range": {
      "value": "$0-$5k",
      "is_authorized": true,
      "status": 0
    },
    "video_gpm_range": {
      "value": "$0-$5k",
      "is_authorized": true,
      "status": 0
    },
    "live_gpm_range": {
      "value": "$0-$5k",
      "is_authorized": true,
      "status": 0
    },
    "units_sold_range": {
      "value": "0-10",
      "is_authorized": true,
      "status": 0
    },
    "med_commission_rate": {
      "value": 400,
      "is_authorized": true,
      "status": 0
    },
    "partnered_brand": {
      "brand": [
        {
          "id": "7046980902877923073",
          "name": "ARZOPA"
        },
        {
          "id": "7280837469960980230",
          "name": "Gamesir"
        }
      ],
      "is_authorized": true,
      "status": 0,
      "value": [
        {
          "id": "7046980902877923073",
          "name": "ARZOPA"
        },
        {
          "id": "7280837469960980230",
          "name": "Gamesir"
        }
      ]
    },
    "med_commission_rate_range": {
      "value": "0%-5%",
      "is_authorized": true,
      "status": 0
    },
    "avg_revenue_per_buyer_range": {
      "value": "$20+",
      "is_authorized": true,
      "status": 0
    },
    "promoted_product_num": {
      "value": "3",
      "is_authorized": true,
      "status": 0
    },
    "live_streaming_cnt_30d": {
      "value": "0",
      "is_authorized": true,
      "status": 0
    },
    "live_med_view_cnt": {
      "value": "6420",
      "is_authorized": true,
      "status": 0
    },
    "ec_live_med_view_cnt": {
      "value": "0",
      "is_authorized": true,
      "status": 0
    },
    "live_med_like_cnt": {
      "value": "1",
      "is_authorized": true,
      "status": 0
    },
    "ec_live_med_like_cnt": {
      "value": "0",
      "is_authorized": true,
      "status": 0
    },
    "live_med_comment_cnt": {
      "value": "0",
      "is_authorized": true,
      "status": 0
    },
    "ec_live_med_comment_cnt": {
      "value": "0",
      "is_authorized": true,
      "status": 0
    },
    "live_med_share_cnt": {
      "value": "0",
      "is_authorized": true,
      "status": 0
    },
    "ec_live_med_share_cnt": {
      "value": "0",
      "is_authorized": true,
      "status": 0
    },
    "video_publish_cnt_30d": {
      "value": "34",
      "is_authorized": true,
      "status": 0
    },
    "video_med_view_cnt": {
      "value": "2570",
      "is_authorized": true,
      "status": 0
    },
    "ec_video_med_view_cnt": {
      "value": "57713",
      "is_authorized": true,
      "status": 0
    },
    "video_med_like_cnt": {
      "value": "60",
      "is_authorized": true,
      "status": 0
    },
    "ec_video_med_like_cnt": {
      "value": "983",
      "is_authorized": true,
      "status": 0
    },
    "video_med_comment_cnt": {
      "value": "2",
      "is_authorized": true,
      "status": 0
    },
    "ec_video_med_comment_cnt": {
      "value": "11",
      "is_authorized": true,
      "status": 0
    },
    "video_med_share_cnt": {
      "value": "7",
      "is_authorized": true,
      "status": 0
    },
    "ec_video_med_share_cnt": {
      "value": "189",
      "is_authorized": true,
      "status": 0
    },
    "follower_genders_v2": {
      "is_authorized": true,
      "status": 0
    },
    "follower_ages_v2": {
      "is_authorized": true,
      "status": 0
    },
    "ec_video_publish_cnt_30d": {
      "value": "1",
      "is_authorized": true,
      "status": 0
    },
    "ec_live_streaming_cnt_30d": {
      "value": "0",
      "is_authorized": true,
      "status": 0
    },
    "creator_permission_tag": {
      "value": 2,
      "is_authorized": true,
      "status": 0
    },
    "recommend_reason": {
      "is_authorized": true,
      "status": 0
    },
    "sample_fulfillment_rate": {
      "value": 2288,
      "is_authorized": true,
      "status": 0
    },
    "has_invited_before_90d": {
      "is_authorized": true,
      "status": 0
    },
    "creator_fulfillment_reviews": {
      "is_authorized": true,
      "status": 0
    },
    "creator_fulfillment_score_90d": {
      "is_authorized": true,
      "status": 0
    },
    "pps_score": {
      "is_authorized": true,
      "status": 0
    },
    "is_in_flat_fee_whitelist": {
      "is_authorized": true,
      "status": 0
    },
    "is_rising_star": {
      "is_authorized": true,
      "status": 0
    },
    "sample_credit_total_score": {
      "value": 67,
      "is_authorized": true,
      "status": 0
    },
    "sample_credit_total_rank": {
      "value": 66,
      "is_authorized": true,
      "status": 0
    },
    "sample_credit_fulfillment_score": {
      "value": 60,
      "is_authorized": true,
      "status": 0
    },
    "sample_credit_fulfillment_rank": {
      "value": 56,
      "is_authorized": true,
      "status": 0
    },
    "sample_credit_diligence_score": {
      "value": 64,
      "is_authorized": true,
      "status": 0
    },
    "sample_credit_diligence_rank": {
      "value": 54,
      "is_authorized": true,
      "status": 0
    },
    "sample_credit_sales_ability_score": {
      "value": 65,
      "is_authorized": true,
      "status": 0
    },
    "sample_credit_sales_ability_rank": {
      "value": 63,
      "is_authorized": true,
      "status": 0
    },
    "sample_credit_content_quality_score": {
      "value": 76,
      "is_authorized": true,
      "status": 0
    },
    "sample_credit_content_quality_rank": {
      "value": 74,
      "is_authorized": true,
      "status": 0
    },
    "sample_credit_evaluate_duration": {
      "value": "20251219-20260117",
      "is_authorized": true,
      "status": 0
    },
    "vertical_pro_category": {
      "is_authorized": true,
      "status": 0
    },
    "vat": {
      "is_authorized": true,
      "status": 0
    }
  },
  "requestId": "fd985f8d-a757-49b8-98fc-dc8909f176b0"
}
πŸͺ™6 creditsper request

Copy for AI

πŸ€– Why Code When AI Can Do It For You?

Stop writing code like it’s 1970! Let AI do the heavy lifting - click the sparkles to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.

Authorizations

Authorization
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx Get your API key from the Dashboard.

Query Parameters

creator_oecuid
string
default:7494008088472553296
required

Creator's TikTok Shop unique ID (numeric string)

Example:

"7494008088472553296"

region
string
default:US
required

Choose one of US, DE, TH, MY, ID, PH, VN

Example:

"US"

Response

Success

The response is of type object.