---
title: "Get TikTok profile"
method: POST
path: "/api/v1/platform/scrapers/tiktok/profile"
tags: ["Scrapers"]
---

# Get TikTok profile

`POST /api/v1/platform/scrapers/tiktok/profile`

Fetch public profile details and recent videos for a TikTok username.

## Request body

- PlatformTikTokUsernameDto
  - `username` string, required
  - `maxVideos` number

## Response `200`

TikTok profile and video data.

- object
  - `data` TikTokProfileScrapeResponseDto, required
    - `profile` TikTokProfileSeedResponseDto, required
      - `username` string, required
      - `tiktok_user_id` string, nullable
      - `display_name` string, nullable
      - `bio` string, nullable
      - `follower_count` number, nullable
      - `following_count` number, nullable
      - `verified` boolean, nullable
      - `avatar_url` string, nullable
    - `videos` TikTokVideoResponseDto[], required
      - `id` string, required
      - `platform_video_id` string, required
      - `tiktok_profile_id` string, nullable
      - `caption` string, nullable
      - `post_url` string, nullable
      - `author_username` string, nullable
      - `author_display_name` string, nullable
      - `author_profile_url` string, nullable
      - `play_count` number, nullable
      - `like_count` number, nullable
      - `comment_count` number, nullable
      - `share_count` number, nullable
      - `hashtags` string[], nullable
      - `cdn_url` string, nullable
      - `s3_key` string, nullable
      - `thumbnail_s3_key` string, nullable
      - `duration_secs` number, nullable
      - `posted_at` string, nullable
      - `created_at` string, required
    - `relatedVideos` TikTokRelatedVideoResponseDto[], required
      - `relationship` 'collaboration', required
      - `matched_username` string, required
      - `video` TikTokVideoResponseDto, required
        - `id` string, required
        - `platform_video_id` string, required
        - `tiktok_profile_id` string, nullable
        - `caption` string, nullable
        - `post_url` string, nullable
        - `author_username` string, nullable
        - `author_display_name` string, nullable
        - `author_profile_url` string, nullable
        - `play_count` number, nullable
        - `like_count` number, nullable
        - `comment_count` number, nullable
        - `share_count` number, nullable
        - `hashtags` string[], nullable
        - `cdn_url` string, nullable
        - `s3_key` string, nullable
        - `thumbnail_s3_key` string, nullable
        - `duration_secs` number, nullable
        - `posted_at` string, nullable
        - `created_at` string, required
      - `collaborators` TikTokProfileSeedResponseDto[], required
        - `username` string, required
        - `tiktok_user_id` string, nullable
        - `display_name` string, nullable
        - `bio` string, nullable
        - `follower_count` number, nullable
        - `following_count` number, nullable
        - `verified` boolean, nullable
        - `avatar_url` string, nullable
  - `meta` PublicResponseMetaDto, required
    - `requestId` string, required

## Other responses

- `400` — The request body or parameters are invalid.
- `401` — Authentication is required.
- `402` — The organization does not have enough credits for this request.
- `500` — An unexpected error occurred.
- `502` — The upstream service could not complete the request.

---

[API](https://skmtc.net/thehog/apis/the-hog-api.md) · [All operations](https://skmtc.net/thehog/apis/the-hog-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thehog/the-hog-api/revisions/f5056017668a/schema)