# TikTok Creator API (`agentx/tiktok-creator-api`) Actor

TikTok creator API that collects Videos or Reposts from one public profile into normalized 61-field rows, with optional comments and no TikTok OAuth.

- **URL**: https://apify.com/agentx/tiktok-creator-api.md
- **Developed by:** [AgentX](https://apify.com/agentx) (community)
- **Categories:** Social media, Videos, Lead generation
- **Features:** Limited permissions
- **Stats:** 24 total users, 1 monthly users, 100.0% runs succeeded, 3 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $1.50 / 1,000 videos

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

**TikTok Creator API is a tiktok creator api that collects public Videos or Reposts from one creator profile and returns normalized 61-field post rows.** Use it for repeatable creator-content research without supplying TikTok OAuth credentials; source privacy, availability, and regional behavior still apply.

[![Apify Users](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.apify.com%2Fv2%2Facts%2Fagentx~tiktok-creator-api\&query=%24.data.stats.totalUsers\&label=Apify%20Users\&color=ff9013\&style=for-the-badge)](https://apify.com/agentx/tiktok-creator-api) [![Apify Runs](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.apify.com%2Fv2%2Facts%2Fagentx~tiktok-creator-api\&query=%24.data.stats.totalRuns\&label=Apify%20Runs\&color=ff9013\&style=for-the-badge)](https://apify.com/agentx/tiktok-creator-api) [![$0.00200 / video](https://img.shields.io/badge/%240.00200%20%2F%20video-4285f4?style=for-the-badge)](https://apify.com/agentx/tiktok-creator-api/pricing) [![Videos + Reposts](https://img.shields.io/badge/Videos%20%2B%20Reposts-34a853?style=for-the-badge)](https://console.apify.com/actors/p5WWQg8bwnUMT9SJw/input) [![API + MCP ready](https://img.shields.io/badge/API%20%2B%20MCP%20ready-fbbc05?style=for-the-badge)](https://apify.com/agentx/tiktok-creator-api/api)

- **Two profile tabs:** choose `Videos` or `Reposts` with a two-value enum.
- **61 documented fields:** every Dataset row has one stable top-level shape, including the Duet and Stitch settings, TikTok's AI-content label, and any on-screen sticker text.
- **Bounded discussion sample:** set `max_comments` to `0` to skip comments or request comments and replies per post.
- **Source-linked output:** each row includes the TikTok post URL, timestamps, engagement, media, music, and creator context.

A smallest useful run requests one video with `max_comments: 0`; its FREE-tier ceiling is $0.01200 including the $0.01000 Actor Start event.

### Why Choose TikTok Creator API

**Creator-tab coverage** turns one public username or profile URL into post rows from either Videos or Reposts. **Decision-ready engagement** keeps plays, likes, comments, shares, and collections beside the source URL, with the creator's follower and like totals read at the moment each post was fetched. **Media and music context** includes covers, dimensions, codec, audio, hashtags, mentions with rename-proof account ids, tagged places, on-screen sticker text, TikTok's own search terms, and music metadata when TikTok exposes them. **Explicit missing values** remain null or empty instead of being replaced with invented zeros. **Optional comments** let a workflow choose post-only collection or a bounded discussion sample.

### Quick Start Guide

#### 1. Configure

Open the input form and keep the working `@openai` Videos example, or provide another public creator profile. Set `max_videos` to the requested row ceiling and `max_comments` to the per-post comment-and-reply ceiling.

#### 2. Run

Start the Actor and watch the status message. A private profile, unavailable Reposts tab, removed post, consent response, or temporary source block can legitimately produce fewer rows than requested.

#### 3. Collect

Read the default Dataset as JSON, JSONL, CSV, Excel, XML, RSS, or through the Dataset API. Use `id` for post identity, `url` for citation, and `processed_at` for observation time.

### Input Parameters

**Sort order.** `sort_by` accepts `Latest`, `Popular` or `Oldest`. TikTok's own API has no sort parameter — measured 2026-08-16, every candidate (`sort_type`, `sortType`, `sort`, `orderBy`, `order_type`) returns an identical newest-first page — so `Popular` and `Oldest` are produced by reading the whole profile and then ordering it. There is no page cap: two profiles were paginated to the source's own end, 342 of a claimed 343 videos in 19 seconds and 1,314 of a claimed 1,348 in 74 seconds, at roughly 15 videos per request. `Latest` stops as soon as `max_videos` is met and stays cheap.

The Actor accepts five required inputs in this exact schema order.

| Parameter | Type | Required | Description | Example |
| --- | --- | --- | --- | --- |
| `tiktok_url` | string | Yes | TikTok username or profile URL; a trailing post path is reduced to its creator username | `https://www.tiktok.com/@openai` |
| `content_type` | string enum | Yes | Profile tab: `Videos` or `Reposts` | `Videos` |
| `sort_by` | string enum | Yes | `Latest`, `Popular` or `Oldest` | `Latest` |
| `max_videos` | integer, min 1 | Yes | Requested row ceiling; fewer may exist, and non-paying users are limited by runtime to 10 | `1` |
| `max_comments` | integer, 0-10,000 | Yes | Total comments plus replies nested in each row; `0` skips the comment endpoints | `0` |

```json
{
  "tiktok_url": "https://www.tiktok.com/@openai",
  "content_type": "Videos",
  "max_videos": 1,
  "max_comments": 0
}
```

The result ceilings are requests, not guarantees. TikTok controls profile privacy, tab availability, and which posts remain public.

### Output Data Schema

Each written item is one resolved TikTok post with exactly 61 top-level fields, every one of them a fact about the post.

| Group | Fields |
| --- | --- |
| Identity and time | `id`, `url`, `created_at`, `description`, `language`, `text_translatable`, `processed_at`, `processor` |
| State and engagement | `quality_score`, `comment_enabled`, `is_advertisement`, `play_count`, `like_count`, `comment_count`, `share_count`, `collect_count`, `duet_enabled`, `stitch_enabled`, `is_aigc`, `category`, `recommend_type`, `diversification_id` |
| Media | `size`, `format`, `bitrate`, `codec`, `cover`, `duration`, `height`, `width`, `quality`, `original_audio`, `caption_reason`, `image_post` |
| Caption entities and place | `hashtags`, `mentions`, `anchors`, `text_extra`, `location_created`, `poi`, `stickers` |
| Music | `music_id`, `music_url`, `music_author`, `music_cover`, `music_title`, `music_duration`, `music_original`, `music_copyrighted`, `music_commerce`, `music_unlimited` |
| Creator counts | `author_followers`, `author_following`, `author_likes`, `author_likes_given`, `author_videos` |
| Search and discussion | `seo_title`, `seo_description`, `seo_keywords`, `suggest_words`, `comments` |

The creator's own identity — id, handle, nickname, avatar, bio, verification, account settings — is not repeated on every row. One run scrapes one creator, so those values would be identical on all of them and say nothing the input did not; the handle is in `url`. The five counts above do ship per row, because they are read at the moment each video is fetched and move during a long run.

Abbreviated example; a real row contains all 61 fields and arrays are shortened here:

```json
{
  "id": "7672796487218121997",
  "url": "https://www.tiktok.com/@openai/photo/7672796487218121997",
  "created_at": "2026-08-11T15:22:07+00:00",
  "description": "Example public post caption #example",
  "play_count": 13100,
  "like_count": 491,
  "diversification_id": 10041,
  "hashtags": ["example"],
  "text_extra": [{"type": 1, "hashtag": "example", "username": null, "sec_uid": null, "start": 29, "end": 37, "is_commerce": false}],
  "poi": null,
  "stickers": [{"type": 9, "texts": ["Peak girl grip"]}],
  "suggest_words": ["moose running on water"],
  "author_followers": 1210000,
  "comments": [],
  "processor": "https://apify.com/agentx/tiktok-creator-api",
  "processed_at": "2026-08-13T06:04:18+00:00"
}
```

Unavailable source fields remain null or empty. Media URLs may be source URLs when a cloud KVS upload is unavailable.

### Integration Examples

Use Actor ID `p5WWQg8bwnUMT9SJw` for HTTP, SDK, automation, and MCP calls; `agentx/tiktok-creator-api` is the equivalent name form.

#### Actor ID

```text
p5WWQg8bwnUMT9SJw
```

#### HTTP

```bash
curl -X POST "https://api.apify.com/v2/acts/p5WWQg8bwnUMT9SJw/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tiktok_url":"https://www.tiktok.com/@openai","content_type":"Videos","max_videos":1,"max_comments":0}'
```

#### Python

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("p5WWQg8bwnUMT9SJw").call(run_input={
    "tiktok_url": "https://www.tiktok.com/@openai",
    "content_type": "Videos",
    "max_videos": 1,
    "max_comments": 0,
})
items = list(client.dataset(run["defaultDatasetId"]).iterate_items())
```

#### JavaScript

```javascript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('p5WWQg8bwnUMT9SJw').call({
  tiktok_url: 'https://www.tiktok.com/@openai', content_type: 'Videos', max_videos: 1, max_comments: 0
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
```

For Make.com or n8n, use the Apify Run Actor action with ID `p5WWQg8bwnUMT9SJw`, paste the same four-field JSON, wait for success, then read the default Dataset. For MCP, connect the official [Apify MCP integration](https://docs.apify.com/integrations/mcp) and expose `agentx/tiktok-creator-api` as the tool.

### Pricing

The FREE-tier video price is $0.00200, the Actor Start event is $0.01000 per run, and a one-video run without returned comments costs at most $0.01200.

| Tier | Video row | Video row with non-empty comments | Actor Start |
| --- | ---: | ---: | ---: |
| FREE | $0.00200 | +$0.00080 | $0.01000 |
| BRONZE | $0.00180 | +$0.00072 | $0.01000 |
| SILVER | $0.00160 | +$0.00064 | $0.01000 |
| GOLD | $0.00150 | +$0.00060 | $0.01000 |
| PLATINUM | $0.00150 | +$0.00060 | $0.01000 |
| DIAMOND | $0.00150 | +$0.00060 | $0.01000 |

The comment event is charged once per written video row only when its `comments` array is non-empty, regardless of array length. At 256 MB the platform's minimum Actor Start count is one. A five-video FREE run with no returned comments is $0.02000: $0.01000 + 5 × $0.00200. Prices can change; confirm the [live pricing page](https://apify.com/agentx/tiktok-creator-api/pricing) before production use.

### Use Cases

- **Creator content review:** sort `play_count`, `like_count`, `share_count`, and `collect_count` while retaining `url` for source review.
- **Repost research:** select `Reposts` and compare the returned authors, captions, hashtags, and music context.
- **Editorial discovery:** use `description`, `hashtags`, `mentions`, `anchors`, and `seo_keywords` to organize public posts.
- **Media inventory:** distinguish video rows from `image_post` rows and retain covers, dimensions, duration, codec, and music URLs.
- **Scheduled snapshots:** save `processed_at` with engagement counts to build your own longitudinal table.

### Alternatives

Manual browsing is suitable for checking a few posts once, but it does not provide a repeatable 61-field Dataset or API delivery. TikTok's official [Display API](https://developers.tiktok.com/doc/display-api-overview) is the right choice when a creator authorizes your application and you need TikTok-supported access to that user's profile and recent videos. This Actor instead reads public profile surfaces without creator OAuth. Choose another path if you need private profiles, follower lists, inbox data, publishing, authentication on a user's behalf, guaranteed historical completeness, or legal advice.

### Limits and Troubleshooting

- **No rows →** the profile may be private, unavailable, removed, regionally gated, or temporarily blocked. Verify the public profile URL and retry later with `max_videos: 1`.
- **Fewer rows than requested →** the selected tab may contain fewer public posts or some detail pages may fail. Treat `max_videos` as a ceiling.
- **Empty Reposts →** the account may not expose a Reposts tab. Test `Videos` to isolate tab availability.
- **Empty comments →** comments may be disabled, unavailable, or not returned during the run. The row is still useful and no comment event is charged when the array is empty.
- **Null fields →** TikTok did not expose those values for the post. Do not reinterpret null as zero or false.
- **Source media URL retained →** local download or cloud storage was unavailable, so the original non-empty URL was preserved.

For a reproducible defect, open an [Actor issue](https://apify.com/agentx/tiktok-creator-api/issues) with the run ID, redacted profile, exact four-field input, terminal status, returned row count, and affected field names. Never include tokens or private credentials.

### Trust and Reliability

Runs use Apify's Actor infrastructure, default Dataset, Key-Value Store support, API, schedules, and integrations. Billing follows registered events: Actor Start, each successfully written video row, and each written row with a non-empty comments array. The 61-field schema is explicit, and source-absent values remain empty rather than being fabricated. Each row keeps both the source `url` and the observation timestamp `processed_at`.

### Legal and Compliance

**Public data only.** Configure public creator profiles and collect only the data TikTok exposes on public pages.

**Purpose and retention.** Use the smallest data scope needed, review comments for personal data, and apply appropriate retention, access, and deletion controls.

**Independent service.** This Actor is not affiliated with TikTok. You are responsible for TikTok's terms, applicable privacy and intellectual-property law, and the legality of your use case.

### Frequently Asked Questions

#### Can I fetch tiktok creator videos without oauth?

Yes. The Actor accepts one public username or profile URL and does not require a TikTok OAuth token, but it cannot access private or creator-authorized data.

#### Can I collect tiktok creator reposts by username?

Yes. Set `content_type` to `Reposts`; the profile must expose that tab and source availability can reduce the result count.

#### Is there a free TikTok creator API?

Apify accounts include platform credits that may cover small tests; this Actor still uses the registered Actor Start, video, and optional comment events.

#### Can I schedule runs to monitor TikTok creators over time?

Yes. Use Apify Schedules and store `processed_at` with engagement fields to build your own snapshots; the Actor does not maintain history itself.

#### Does max_comments charge once per comment?

No. A Comment event is charged once per written video row when the returned `comments` array is non-empty, not once per nested comment.

#### Why are some fields null?

Null means TikTok did not expose the value for that post during the run. It is not converted to zero, false, or an inferred value.

#### Can the Actor return photo posts?

Yes. Photo posts carry source image URLs in `image_post`, while video-oriented fields may be null.

### Related AgentX Actors

The AgentX catalog contains purpose-specific Actors; these three are closest to TikTok creator-content workflows, followed by the complete catalog by category.

Closest to this Actor:

- [TikTok Live Downloader](https://apify.com/agentx/tiktok-live-downloader) for saving live-stream media rather than profile posts.
- [TikTok Transcript](https://apify.com/agentx/tiktok-transcript) for speech-to-text workflows on TikTok media.
- [Instagram Creator Scraper](https://apify.com/agentx/instagram-creator-scraper) for creator-content data on Instagram.

#### Business and Market Intelligence

- **[All Web Search Scraper](https://apify.com/agentx/all-web-search-scraper)** — multi-engine web search across ten independent indexes
- **[Google Keyword Trends](https://apify.com/agentx/google-keyword-trends)** — Google Trends keyword interest, compared five at a time
- **[Google Trends Scraper](https://apify.com/agentx/google-trends-scraper)** — Google Trends trending searches
- **[Google Maps Store Scraper](https://apify.com/agentx/google-maps-store-scraper)** — Google Maps business listings
- **[LinkedIn Company Lookup](https://apify.com/agentx/linkedin-company-lookup)** — LinkedIn company records
- **[LinkedIn Profile Lookup](https://apify.com/agentx/linkedin-profile-lookup)** — LinkedIn profile records
- **[Weather Forecast API](https://apify.com/agentx/weather-forecast-api)** — forecast and historical weather data

#### Jobs and Hiring

- **[All Jobs Scraper](https://apify.com/agentx/all-jobs-scraper)** — multi-platform job listings
- **[Bayt Jobs Scraper](https://apify.com/agentx/bayt-jobs-scraper)** — Bayt job listings
- **[Glassdoor Jobs Scraper](https://apify.com/agentx/glassdoor-jobs-scraper)** — Glassdoor job listings
- **[Indeed Jobs Scraper](https://apify.com/agentx/indeed-jobs-scraper)** — Indeed job listings
- **[JobStreet Company Profile](https://apify.com/agentx/jobstreet-company-profile)** — JobStreet employer records
- **[Jooble Jobs Scraper](https://apify.com/agentx/jooble-jobs-scraper)** — Jooble job listings
- **[LinkedIn Jobs Scraper](https://apify.com/agentx/linkedin-jobs-scraper)** — LinkedIn job listings
- **[Naukri Jobs Scraper](https://apify.com/agentx/naukri-jobs-scraper)** — Naukri job listings
- **[Talent Jobs Scraper](https://apify.com/agentx/talent-jobs-scraper)** — Talent.com job listings
- **[ZipRecruiter Jobs Scraper](https://apify.com/agentx/ziprecruiter-jobs-scraper)** — ZipRecruiter job listings

#### Social Media

- **[All Forums Thread Scraper](https://apify.com/agentx/all-forums-thread-scraper)** — multi-platform forum and Q\&A threads
- **[Instagram Creator Scraper](https://apify.com/agentx/instagram-creator-scraper)** — Instagram creator profiles
- **[Instagram Reels Scraper](https://apify.com/agentx/instagram-reels-scraper)** — Instagram Reels metadata
- **[Instagram Trending Scraper](https://apify.com/agentx/instagram-trending-scraper)** — Instagram trending content
- **[Medium Scraper](https://apify.com/agentx/medium-scraper)** — Medium articles
- **[Medium Profile Scraper](https://apify.com/agentx/medium-profile-scraper)** — Medium author profiles
- **[Reddit Profile Scraper](https://apify.com/agentx/reddit-profile-scraper)** — Reddit user profiles
- **[Reddit Viral Scraper](https://apify.com/agentx/reddit-viral-scraper)** — Reddit viral posts
- **[SubReddit Info Scraper](https://apify.com/agentx/subreddit-info-scraper)** — subreddit metadata
- **[Subreddit Members Scraper](https://apify.com/agentx/subreddit-members-scraper)** — subreddit member lists
- **[Subreddit Posts Scraper](https://apify.com/agentx/subreddit-posts-scraper)** — subreddit post feeds
- **[Telegram Chat Scraper](https://apify.com/agentx/telegram-chat-scraper)** — Telegram chat messages
- **[Telegram Info Scraper](https://apify.com/agentx/telegram-info-scraper)** — Telegram channel metadata
- **[Telegram Member Adder](https://apify.com/agentx/telegram-member-adder)** — Telegram group membership management
- **[Telegram Member Scraper](https://apify.com/agentx/telegram-member-scraper)** — Telegram group members
- **[Telegram Private Group Scraper](https://apify.com/agentx/telegram-private-group-scraper)** — private Telegram group data
- **[TikTok User Lookup](https://apify.com/agentx/tiktok-user-lookup)** — TikTok account records
- **[X Twitter Community API](https://apify.com/agentx/x-twitter-community-api)** — X community data
- **[X Twitter Profile Lookup](https://apify.com/agentx/x-twitter-profile-lookup)** — X profile records
- **[YouTube Creator Email Scraper](https://apify.com/agentx/youtube-creator-email-scraper)** — YouTube creator contact data

#### Video, Transcripts and Downloads

- **[All Video Scraper](https://apify.com/agentx/all-video-scraper)** — multi-platform video metadata
- **[All Short Videos Scraper](https://apify.com/agentx/all-short-videos-scraper)** — short-video keyword search across two independent indexes
- **[All Image Scraper](https://apify.com/agentx/all-image-scraper)** — image search and download across five engines
- **[All Short Drama Downloader](https://apify.com/agentx/all-short-drama-downloader)** — short-drama episodes from fifteen official apps
- **[Video Transcript](https://apify.com/agentx/video-transcript)** — multi-platform transcripts
- **[Video Captions Downloader](https://apify.com/agentx/video-captions-downloader)** — caption files
- **[Video to Social Post](https://apify.com/agentx/video-to-social-post)** — video repurposed into social copy
- **[YouTube Transcript](https://apify.com/agentx/youtube-transcript)** — YouTube transcripts
- **[TikTok Transcript](https://apify.com/agentx/tiktok-transcript)** — TikTok transcripts
- **[X Twitter Transcript](https://apify.com/agentx/x-twitter-transcript)** — X video transcripts
- **[Facebook Transcript](https://apify.com/agentx/facebook-transcript)** — Facebook video transcripts
- **[Bilibili Transcript](https://apify.com/agentx/bilibili-transcript)** — Bilibili transcripts
- **[Dailymotion Transcript](https://apify.com/agentx/dailymotion-transcript)** — Dailymotion transcripts
- **[Rutube Transcript](https://apify.com/agentx/rutube-transcript)** — Rutube transcripts
- **[Loom Transcript](https://apify.com/agentx/loom-transcript)** — Loom transcripts
- **[Wistia Transcript](https://apify.com/agentx/wistia-transcript)** — Wistia transcripts
- **[Instagram Reels Downloader](https://apify.com/agentx/instagram-reels-downloader)** — Reels downloads
- **[Kick Clip Downloader](https://apify.com/agentx/kick-clip-downloader)** — Kick clip downloads
- **[Linkedin Video Downloader](https://apify.com/agentx/linkedin-video-downloader)** — LinkedIn video downloads
- **[Pinterest Video Downloader](https://apify.com/agentx/pinterest-video-downloader)** — Pinterest video downloads
- **[Reddit Video Downloader](https://apify.com/agentx/reddit-video-downloader)** — Reddit video downloads
- **[Snapchat Video Downloader](https://apify.com/agentx/snapchat-video-downloader)** — Snapchat video downloads
- **[TED Talk Downloader](https://apify.com/agentx/ted-talk-downloader)** — TED talk downloads
- **[TikTok Live Downloader](https://apify.com/agentx/tiktok-live-downloader)** — TikTok live downloads
- **[Twitch VOD Downloader](https://apify.com/agentx/twitch-vod-downloader)** — Twitch VOD downloads
- **[Zoom Recording Downloader](https://apify.com/agentx/zoom-recording-downloader)** — Zoom recording downloads

#### E-Commerce and Retail

- **[All Shopping Scraper](https://apify.com/agentx/all-shopping-scraper)** — multi-platform product data
- **[AliExpress Product Scraper](https://apify.com/agentx/aliexpress-product-scraper)** — AliExpress products
- **[Amazon Storefront Scraper](https://apify.com/agentx/amazon-storefront-scraper)** — Amazon Brand Store pages
- **[Bol Product Scraper](https://apify.com/agentx/bol-product-scraper)** — Bol.com products
- **[eBay Seller Leads API](https://apify.com/agentx/ebay-seller-leads-api)** — eBay seller records
- **[Hepsiburada Product Scraper](https://apify.com/agentx/hepsiburada-product-scraper)** — Hepsiburada products
- **[Kakaku Product Scraper](https://apify.com/agentx/kakaku-product-scraper)** — Kakaku.com products
- **[Rakuten Product Scraper](https://apify.com/agentx/rakuten-product-scraper)** — Rakuten products

#### Classifieds and Automotive

- **[All Vehicle Scraper](https://apify.com/agentx/all-vehicle-scraper)** — multi-platform vehicle listings
- **[AutoTrader Vehicle Search](https://apify.com/agentx/autotrader-vehicle-search)** — AutoTrader US listings
- **[AutoTrader UK Vehicle Search](https://apify.com/agentx/autotrader-uk-vehicle-search)** — AutoTrader UK listings

#### Real Estate

- **[All Property Scraper](https://apify.com/agentx/all-property-scraper)** — multi-platform property listings
- **[Homes Property Scraper](https://apify.com/agentx/homes-property-scraper)** — Homes.com listings
- **[MagicBricks Property Scraper](https://apify.com/agentx/magicbricks-property-scraper)** — MagicBricks listings
- **[NoBroker Property Scraper](https://apify.com/agentx/nobroker-property-scraper)** — NoBroker listings
- **[Property24 Property Scraper](https://apify.com/agentx/property24-property-scraper)** — Property24 listings
- **[Realtor Property Scraper](https://apify.com/agentx/realtor-property-scraper)** — Realtor.com listings
- **[Zillow Property Scraper](https://apify.com/agentx/zillow-property-scraper)** — Zillow listings

### Support and Community

Ask about creator tabs, Dataset fields, comments, or billing in the [AgentX community on Telegram](https://t.me/Apify_Actor); for a reproducible bug, open an [Actor issue](https://apify.com/agentx/tiktok-creator-api/issues) with the run ID and exact input.

AgentX is an Arcyton brand — [arcyton.com](https://arcyton.com).

**Last Updated:** August 12, 2026

# Actor input Schema

## `tiktok_url` (type: `string`):

TikTok username or profile URL; any trailing video/photo path is reduced to the creator username, so this is not a direct single-video lookup

## `content_type` (type: `string`):

Profile tab to request: Videos or Reposts; rows follow source availability and returned tab order, and Reposts can be unavailable

## `sort_by` (type: `string`):

Order the profile tab is read in: Latest is the source's own order; Popular ranks by play count and Oldest by date, and both read the whole profile first, so they take longer on a large creator

## `max_videos` (type: `integer`):

Requested maximum rows from the selected tab; fewer or zero can be returned, and non-paying users are limited by runtime to 10

## `max_comments` (type: `integer`):

Requested maximum total comments plus replies nested in each returned video row; fewer can be available, 0 skips comments, and non-paying users are limited to 10

## Actor input object example

```json
{
  "tiktok_url": "https://www.tiktok.com/@openai",
  "content_type": "Videos",
  "sort_by": "Latest",
  "max_videos": 1,
  "max_comments": 1
}
```

# Actor output Schema

## `results` (type: `string`):

Resolved TikTok post rows written to the default Dataset.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "tiktok_url": "https://www.tiktok.com/@openai",
    "content_type": "Videos",
    "sort_by": "Latest",
    "max_videos": 1,
    "max_comments": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("agentx/tiktok-creator-api").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "tiktok_url": "https://www.tiktok.com/@openai",
    "content_type": "Videos",
    "sort_by": "Latest",
    "max_videos": 1,
    "max_comments": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("agentx/tiktok-creator-api").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "tiktok_url": "https://www.tiktok.com/@openai",
  "content_type": "Videos",
  "sort_by": "Latest",
  "max_videos": 1,
  "max_comments": 1
}' |
apify call agentx/tiktok-creator-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,agentx/tiktok-creator-api"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/p5WWQg8bwnUMT9SJw/builds/mz999LaeIVR9vZdLd/openapi.json