# TikTok Public Videos & Profiles Scraper (`zinin/tiktok-public-videos-profiles-scraper`) Actor

Scrape public TikTok video cards, play counts, and current creator profile metrics from official embed pages without login.

- **URL**: https://apify.com/zinin/tiktok-public-videos-profiles-scraper.md
- **Developed by:** [Tim Zinin](https://apify.com/zinin) (community)
- **Categories:** Social media, Marketing
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.40 / 1,000 public tiktok video delivereds

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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **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 usage examples, see the [API](#api) section below.

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

# README

## TikTok Public Videos & Profiles Scraper

Collect the current public video cards and profile metrics that TikTok exposes through its first-party creator embed page. Give the actor one to five exact public profile URLs and receive up to 50 useful video rows. Each paid row includes the current profile nickname, follower, following, and heart counts from the same source page, so a researcher or social team can snapshot a short creator watchlist without a login.

```json
{"profileUrls":["https://www.tiktok.com/@nba"],"maxVideos":10}
```

The result-only price is **$0.002 per useful video**, with 10/20/30% tier prices of $0.0018, $0.0016, and $0.0014. There is no start or diagnostic fee. Set a positive Apify Max total charge before running: `maxTotalChargeUsd: 0` can mean an account default, not zero spend. A positive cap below one result price stops before the actor requests a source page.

```json
{"videoId":"7654752160051121422","videoURL":"https://www.tiktok.com/@nba/video/7654752160051121422","authorUniqueId":"nba","playCount":5700000,"followerCount":27200000,"sourceURL":"https://www.tiktok.com/embed/@nba"}
```

TikTok’s embed list can contain pinned or unordered cards and is not a full archive. The actor does not search TikTok, scroll profile history, infer timestamps, likes, or comments, or emit private data. Source fields that TikTok does not expose are omitted; source-visible nullable fields remain null when absent.

![TikTok public video cards and profile metrics](https://api.apify.com/v2/key-value-stores/IwI7VoxszQjT6v69X/records/tiktok-public-videos-profiles-scraper-e59573e0bb357893-readme-hero.webp?signature=Zdxr3bKKCw7dfuVQDlnX)

### Repeatable monitoring

Use the Quick Creator Check task for a first sample, Creator Watchlist for a larger bounded snapshot, and Repeat Creator Snapshot for scheduled observations. Replace the example profile URLs with your own public watchlist. Each run reads TikTok again; compare `videoId`, `playCount`, and profile counts with your previous export. The actor does not calculate changes or guarantee that an embed contains every newly posted video.

![Public profile URL to fresh creator embed to verified video rows](https://api.apify.com/v2/key-value-stores/IwI7VoxszQjT6v69X/records/tiktok-public-videos-profiles-scraper-b7c2c1d4bc09ef36-readme-workflow.webp?signature=v6fk3LGoqCkmU9RyOIAs)

### Output and coverage

Download Dataset rows as JSON or CSV. The free OUTPUT record includes the outcome, delivered video and confirmed billing counts, source coverage, and a snapshot of confirmed rows. `source_failed` means every attempted profile failed; `empty` means a valid source contained no useful public video cards. A partial snapshot or a budget stop is explicitly reported. Private profiles, private cards, mismatched authors, and repeated video IDs are omitted.

The price is per delivered video, not per profile: ten delivered videos cost $0.02 before tier discounts. Bronze, Silver, and Gold or higher tiers receive 10%, 20%, and 30% discounts. Set a positive Max total charge to bound result fees. No proxy or login input is required.

# Actor input Schema

## `profileUrls` (type: `array`):

Exact HTTPS www.tiktok.com/@{username} profile URLs.

## `maxVideos` (type: `integer`):

Total video rows across all profiles. The embedded source can be pinned or unordered and is not a full archive.

## Actor input object example

```json
{
  "profileUrls": [
    "https://www.tiktok.com/@nba"
  ],
  "maxVideos": 10
}
```

# Actor output Schema

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

One source-visible public video card and current profile metrics per row.

## `summary` (type: `string`):

Bounded profile coverage and delivery state.

# 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 = {
    "profileUrls": [
        "https://www.tiktok.com/@nba"
    ],
    "maxVideos": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("zinin/tiktok-public-videos-profiles-scraper").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 = {
    "profileUrls": ["https://www.tiktok.com/@nba"],
    "maxVideos": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("zinin/tiktok-public-videos-profiles-scraper").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 '{
  "profileUrls": [
    "https://www.tiktok.com/@nba"
  ],
  "maxVideos": 10
}' |
apify call zinin/tiktok-public-videos-profiles-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,zinin/tiktok-public-videos-profiles-scraper"
        }
    }
}
```

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/uLTUhzzmSrlLMlRxC/builds/5fxuUHQKBoOBxiSJR/openapi.json