Skip to main content
GET
/
v1
/
tiktok
/
shop-creator
/
audience
cURL
curl --request GET \
  --url 'https://api.keyapi.ai/v1/tiktok/shop-creator/audience?creator_oecuid=7494008088472553296&region=US' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'
{
  "code": 0,
  "message": "success",
  "data": {
    "follower_genders_v2": {
      "value": [
        {
          "key": "male",
          "value": "0.6314"
        },
        {
          "key": "female",
          "value": "0.3137"
        }
      ],
      "is_authorized": true,
      "status": 0
    },
    "follower_ages_v2": {
      "value": [
        {
          "key": "35-44",
          "value": "0.3960"
        },
        {
          "key": "25-34",
          "value": "0.3623"
        },
        {
          "key": "18-24",
          "value": "0.1407"
        },
        {
          "key": "45-54",
          "value": "0.0805"
        },
        {
          "key": "55+",
          "value": "0.0202"
        }
      ],
      "is_authorized": true,
      "status": 0
    },
    "follower_state_location": {
      "value": [
        {
          "key": "TEXAS",
          "value": "1109"
        },
        {
          "key": "CALIFORNIA",
          "value": "983"
        },
        {
          "key": "FLORIDA",
          "value": "761"
        },
        {
          "key": "NEW YORK",
          "value": "657"
        },
        {
          "key": "ILLINOIS",
          "value": "418"
        }
      ],
      "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": {
      "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": {
      "is_authorized": true,
      "status": 0
    },
    "sample_credit_total_rank": {
      "is_authorized": true,
      "status": 0
    },
    "sample_credit_fulfillment_score": {
      "is_authorized": true,
      "status": 0
    },
    "sample_credit_fulfillment_rank": {
      "is_authorized": true,
      "status": 0
    },
    "sample_credit_diligence_score": {
      "is_authorized": true,
      "status": 0
    },
    "sample_credit_diligence_rank": {
      "is_authorized": true,
      "status": 0
    },
    "sample_credit_sales_ability_score": {
      "is_authorized": true,
      "status": 0
    },
    "sample_credit_sales_ability_rank": {
      "is_authorized": true,
      "status": 0
    },
    "sample_credit_content_quality_score": {
      "is_authorized": true,
      "status": 0
    },
    "sample_credit_content_quality_rank": {
      "is_authorized": true,
      "status": 0
    },
    "sample_credit_evaluate_duration": {
      "is_authorized": true,
      "status": 0
    },
    "vertical_pro_category": {
      "is_authorized": true,
      "status": 0
    },
    "vat": {
      "is_authorized": true,
      "status": 0
    }
  },
  "requestId": "0621634a-f042-46eb-98ce-dbc2c991a192"
}
πŸͺ™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.