---
title: "User's Audience Demographics"
method: GET
path: "/v1/scrape/tiktok/demographics"
tags: ["tiktok"]
---

# User's Audience Demographics

`GET /v1/scrape/tiktok/demographics`

## Request

- Base URL: `https://api.sociavault.com`
- URL: `https://api.sociavault.com/v1/scrape/tiktok/demographics`
- Auth: API key in header `X-API-Key`

Returns audience demographic data for a TikTok user. Currently includes audience country distribution.

**Credit Cost:** 26 credits per request

## Query parameters

- `handle` string, required

## Response `200`

Successful response

- object
  - `success` boolean, required
  - `audienceLocations` object[], required
    - `country` string, required
    - `countryCode` string, required
    - `count` integer, required
    - `percentage` string, required

## Other responses

- `400`: Bad Request - Invalid parameters or missing required fields
- `401`: Unauthorized - Invalid or missing API key
- `402`: Payment Required - Insufficient credits
- `500`: Internal Server Error - Service configuration or processing error

---

[API](https://skmtc.dev/sociavault/apis/sociavault-api.md) · [All operations](https://skmtc.dev/sociavault/apis/sociavault-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sociavault/apis/sociavault-api/revisions/0a430c97f53a?raw)