# TikTok Live Target API Example for Teams

**Use case:** 

A ready-to-run example that reads a TikTok creator profile's uploads, pointed at a target verified live today, with normalized fields.

## Input

```json
{
  "tiktok_url": "https://www.tiktok.com/@natgeo",
  "content_type": "Videos",
  "sort_by": "Popular",
  "max_videos": 3,
  "max_comments": 0
}
```

## Output

```json
{
  "id": {
    "label": "Video ID",
    "format": "string"
  },
  "url": {
    "label": "Video URL",
    "format": "string"
  },
  "created_at": {
    "label": "Created At",
    "format": "string"
  },
  "description": {
    "label": "Description",
    "format": "string"
  },
  "quality_score": {
    "label": "Video Quality Score",
    "format": "string"
  },
  "language": {
    "label": "Language",
    "format": "string"
  },
  "text_translatable": {
    "label": "Text Translatable",
    "format": "boolean"
  },
  "comment_enabled": {
    "label": "Comment Status",
    "format": "string"
  },
  "is_advertisement": {
    "label": "Is Advertisement",
    "format": "boolean"
  },
  "play_count": {
    "label": "Play Count",
    "format": "integer"
  },
  "like_count": {
    "label": "Like Count",
    "format": "integer"
  },
  "comment_count": {
    "label": "Comment Count",
    "format": "integer"
  },
  "share_count": {
    "label": "Share Count",
    "format": "integer"
  },
  "collect_count": {
    "label": "Collect Count",
    "format": "integer"
  },
  "duet_enabled": {
    "label": "Duet Enabled",
    "format": "boolean"
  },
  "stitch_enabled": {
    "label": "Stitch Enabled",
    "format": "boolean"
  },
  "is_aigc": {
    "label": "Is AIGC",
    "format": "boolean"
  },
  "category": {
    "label": "Category",
    "format": "string"
  },
  "recommend_type": {
    "label": "Recommend Type",
    "format": "string"
  },
  "diversification_id": {
    "label": "Diversification Id",
    "format": "integer"
  },
  "size": {
    "label": "File Size",
    "format": "integer"
  },
  "format": {
    "label": "Format",
    "format": "string"
  },
  "bitrate": {
    "label": "Bitrate",
    "format": "integer"
  },
  "codec": {
    "label": "Codec",
    "format": "string"
  },
  "cover": {
    "label": "Cover Image",
    "format": "string"
  },
  "duration": {
    "label": "Duration",
    "format": "integer"
  },
  "height": {
    "label": "Height",
    "format": "integer"
  },
  "width": {
    "label": "Width",
    "format": "integer"
  },
  "quality": {
    "label": "Quality",
    "format": "string"
  },
  "original_audio": {
    "label": "Original Audio",
    "format": "boolean"
  },
  "caption_reason": {
    "label": "Caption Reason",
    "format": "string"
  },
  "image_post": {
    "label": "Image Post",
    "format": "array"
  },
  "hashtags": {
    "label": "Hashtags",
    "format": "array"
  },
  "mentions": {
    "label": "Mentions",
    "format": "array"
  },
  "anchors": {
    "label": "Anchors",
    "format": "array"
  },
  "text_extra": {
    "label": "Text Extra",
    "format": "array"
  },
  "location_created": {
    "label": "Location Created",
    "format": "string"
  },
  "poi": {
    "label": "Poi",
    "format": "object"
  },
  "stickers": {
    "label": "Stickers",
    "format": "array"
  },
  "music_id": {
    "label": "Music ID",
    "format": "string"
  },
  "music_url": {
    "label": "Music URL",
    "format": "string"
  },
  "music_author": {
    "label": "Music Author",
    "format": "string"
  },
  "music_cover": {
    "label": "Music Cover",
    "format": "string"
  },
  "music_title": {
    "label": "Music Title",
    "format": "string"
  },
  "music_duration": {
    "label": "Music Duration",
    "format": "integer"
  },
  "music_original": {
    "label": "Music Original",
    "format": "boolean"
  },
  "music_copyrighted": {
    "label": "Music Copyrighted",
    "format": "boolean"
  },
  "music_commerce": {
    "label": "Music Commerce",
    "format": "boolean"
  },
  "music_unlimited": {
    "label": "Music Unlimited",
    "format": "boolean"
  },
  "author_followers": {
    "label": "Author Followers",
    "format": "integer"
  },
  "author_following": {
    "label": "Author Following",
    "format": "integer"
  },
  "author_likes": {
    "label": "Author Likes Received",
    "format": "integer"
  },
  "author_likes_given": {
    "label": "Author Likes Given",
    "format": "integer"
  },
  "author_videos": {
    "label": "Author Video Count",
    "format": "integer"
  },
  "seo_title": {
    "label": "SEO Title",
    "format": "string"
  },
  "seo_description": {
    "label": "SEO Description",
    "format": "string"
  },
  "seo_keywords": {
    "label": "SEO Keywords",
    "format": "array"
  },
  "suggest_words": {
    "label": "Suggest Words",
    "format": "array"
  },
  "comments": {
    "label": "Comments",
    "format": "array"
  },
  "processor": {
    "label": "Processor",
    "format": "string"
  },
  "processed_at": {
    "label": "Processed At",
    "format": "string"
  }
}
```

## About this Actor

This example demonstrates how to use [TikTok Creator API](https://apify.com/agentx/tiktok-creator-api.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/agentx/tiktok-creator-api.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
This Task's input is already configured above — use it as-is rather than inventing a new one.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/agentx/tiktok-creator-api.md

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).