Pricing

from $2.87 / 1,000 results

TikTok Ultimate Scraper | Videos, Hashtags & Analytics

Scrape TikTok videos, profiles, hashtags, search, followers, Creative Center analytics and trends. Export views, likes, comments, music and author stats to JSON/CSV via Apify API.

Pricing

from $2.87 / 1,000 results

Rating

0.0

(0)

Developer

Rémi Pelloux

Actor stats

Bookmarked

Total users

Monthly active users

2 days ago

Last modified

Categories

Automation

Social media

You can access the TikTok Ultimate Scraper | Videos, Hashtags & Analytics programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.9",
    "x-build-id": "Q6vC1RQytfctpUvrH"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/rp_openpro.ai~tiktok-ultimate-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-rp_openpro.ai-tiktok-ultimate-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/rp_openpro.ai~tiktok-ultimate-scraper/runs": {
      "post": {
        "operationId": "runs-sync-rp_openpro.ai-tiktok-ultimate-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/rp_openpro.ai~tiktok-ultimate-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-rp_openpro.ai-tiktok-ultimate-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "mode": {
            "title": "Scraping mode",
            "enum": [
              "scrape",
              "hashtagAnalytics",
              "trendDiscovery"
            ],
            "type": "string",
            "description": "Choose what to scrape: standard TikTok content, hashtag analytics, or Creative Center trends.",
            "default": "scrape"
          },
          "hashtags": {
            "title": "Hashtags",
            "type": "array",
            "description": "Hashtags to scrape (without #). Used in scrape and hashtagAnalytics modes.",
            "items": {
              "type": "string"
            }
          },
          "profiles": {
            "title": "Profiles",
            "type": "array",
            "description": "TikTok usernames to scrape (with or without @).",
            "items": {
              "type": "string"
            }
          },
          "search": {
            "title": "Search queries",
            "type": "array",
            "description": "Keywords to search on TikTok.",
            "items": {
              "type": "string"
            }
          },
          "searchQueries": {
            "title": "Search queries (alias)",
            "type": "array",
            "description": "Alias for search — both fields are merged.",
            "items": {
              "type": "string"
            }
          },
          "videoUrls": {
            "title": "Video URLs",
            "type": "array",
            "description": "Direct TikTok video URLs to extract.",
            "items": {
              "type": "string"
            }
          },
          "postURLs": {
            "title": "Video URLs (alias)",
            "type": "array",
            "description": "Alias for videoUrls — both fields are merged.",
            "items": {
              "type": "string"
            }
          },
          "resultsPerPage": {
            "title": "Results per query",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum items to fetch per hashtag, profile, search, or URL.",
            "default": 20
          },
          "maxProfilesPerQuery": {
            "title": "Max profiles",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum number of profile usernames to process.",
            "default": 10
          },
          "excludePinnedPosts": {
            "title": "Exclude pinned posts",
            "type": "boolean",
            "description": "Skip pinned videos from profile results.",
            "default": false
          },
          "scrapeRelatedVideos": {
            "title": "Scrape related videos",
            "type": "boolean",
            "description": "When scraping video URLs, also fetch related/recommended videos.",
            "default": false
          },
          "profileScrapeSections": {
            "title": "Profile sections",
            "type": "array",
            "description": "Which profile data to collect: videos, reposts, followers, following.",
            "default": [
              "videos"
            ],
            "items": {
              "type": "string"
            }
          },
          "profileSorting": {
            "title": "Profile sort order",
            "enum": [
              "latest",
              "popular",
              "oldest"
            ],
            "type": "string",
            "description": "Sort order for profile video lists.",
            "default": "latest"
          },
          "oldestPostDateUnified": {
            "title": "Oldest post date",
            "type": "string",
            "description": "Only include posts on or after this date. Use YYYY-MM-DD or number of days (e.g. 7 = last week)."
          },
          "newestPostDate": {
            "title": "Newest post date",
            "type": "string",
            "description": "Only include posts on or before this date. Use YYYY-MM-DD."
          },
          "searchSection": {
            "title": "Search section",
            "enum": [
              "",
              "video",
              "user"
            ],
            "type": "string",
            "description": "Filter search results by type.",
            "default": ""
          },
          "adsCountryCode": {
            "title": "Analytics country",
            "type": "string",
            "description": "Country code for hashtag analytics and trend discovery (ISO 2-letter, e.g. US, FR, GB).",
            "default": "US"
          },
          "adsTimeRange": {
            "title": "Analytics time range (days)",
            "enum": [
              "7",
              "30",
              "120"
            ],
            "type": "string",
            "description": "Lookback window for Creative Center analytics and trends.",
            "default": "7"
          },
          "adsScrapeHashtags": {
            "title": "Trend: hashtags",
            "type": "boolean",
            "description": "Fetch trending hashtags from Creative Center.",
            "default": true
          },
          "adsScrapeSounds": {
            "title": "Trend: sounds (discontinued by TikTok)",
            "type": "boolean",
            "description": "TikTok removed public trending sounds from Creative Center (listed as 'Coming soon'). Enabling this returns an explanatory error item.",
            "default": false
          },
          "adsScrapeCreators": {
            "title": "Trend: creators (discontinued by TikTok)",
            "type": "boolean",
            "description": "TikTok removed public trending creators from Creative Center (listed as 'Coming soon'). Enabling this returns an explanatory error item.",
            "default": false
          },
          "adsScrapeVideos": {
            "title": "Trend: videos (discontinued by TikTok)",
            "type": "boolean",
            "description": "TikTok removed public trending videos from Creative Center (listed as 'Coming soon'). Enabling this returns an explanatory error item.",
            "default": false
          },
          "adsHashtagIndustry": {
            "title": "Hashtag industry filter",
            "type": "string",
            "description": "Filter trending hashtags by industry (e.g. Beauty & Personal Care)."
          },
          "adsNewOnBoard": {
            "title": "New on board only",
            "type": "boolean",
            "description": "Only hashtags newly entered the trending board.",
            "default": false
          },
          "adsRankType": {
            "title": "Sound rank type",
            "enum": [
              "popular",
              "surging"
            ],
            "type": "string",
            "description": "Popular or surging sound ranking.",
            "default": "popular"
          },
          "adsApprovedForBusinessUse": {
            "title": "Business-approved sounds only",
            "type": "boolean",
            "description": "Only include sounds approved for commercial use.",
            "default": false
          },
          "adsSortCreatorsBy": {
            "title": "Sort creators by",
            "enum": [
              "follower",
              "engagement",
              "avg_views"
            ],
            "type": "string",
            "description": "Ranking metric for trending creators.",
            "default": "follower"
          },
          "adsFollowers": {
            "title": "Creator follower bucket",
            "type": "string",
            "description": "Filter creators by follower count bucket (1–4)."
          },
          "adsAudienceCountry": {
            "title": "Creator audience country",
            "type": "string",
            "description": "Filter trending creators by primary audience country."
          },
          "adsSortVideosBy": {
            "title": "Sort trending videos by",
            "enum": [
              "vv",
              "like",
              "comment",
              "repost"
            ],
            "type": "string",
            "description": "Ranking metric for trending videos.",
            "default": "vv"
          },
          "adsSoundsCountryCode": {
            "title": "Sounds country",
            "type": "string",
            "description": "Country code for trending sounds.",
            "default": "US"
          },
          "adsCreatorsCountryCode": {
            "title": "Creators country",
            "type": "string",
            "description": "Country code for trending creators.",
            "default": "US"
          },
          "adsVideosCountryCode": {
            "title": "Videos country",
            "type": "string",
            "description": "Country code for trending videos.",
            "default": "US"
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Residential proxies are required for reliable TikTok scraping — TikTok blocks datacenter IPs. Trend discovery (Creative Center) works with datacenter proxies too."
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Parallel workers for direct video URL scraping and hashtag analytics. Browser-based scraping (hashtags, profiles, search) stays sequential for stability.",
            "default": 4
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

TikTok Scraper API — Videos, Profiles, Hashtags & Analytics OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for TikTok Ultimate Scraper | Videos, Hashtags & Analytics from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

TikTok Ultimate Scraper | Videos, Hashtags & Analytics API in Python

TikTok Ultimate Scraper | Videos, Hashtags & Analytics API in JavaScript

TikTok Ultimate Scraper | Videos, Hashtags & Analytics API through CLI

TikTok Ultimate Scraper | Videos, Hashtags & Analytics API

TikTok Scraper

rupom888/tiktok-scraper-js

Scrape TikTok videos, user profiles, hashtags, and comments. Search by keyword, hashtag, or username. Extracts views, likes, shares, comments, author stats, music, and more.

Syed Rupom

Tiktok Video Search Scraper

romy/tiktok-video-search-scraper

Search TikTok videos by keyword and extract metadata — views, likes, comments, author info, hashtags, and music. No login or cookies required.

Romy

TikTok Scraper - Videos, Profiles & Hashtags

pear_fight/tiktok-scraper

Scrape TikTok videos, profiles, hashtags & trending content. Extract views, likes, shares, comments, follower stats, bio, sound data. No account or API key needed. Pay per result. Export JSON/CSV/Excel.

Harald

TikTok Scraper - Videos, Profiles, Hashtags & Trends

aiscraperdev/scrape-tiktok-videos-profiles-hashtags

Extract TikTok videos, profiles, hashtags, and search results without login. Filter by date range, likes, and engagement. Get captions, stats, music info, and optional AI transcription. Export structured JSON/CSV. Fast, reliable, no authentication required.

Randeep Dhillon

Tiktok Profile Videos Api Scraper

scrapapi/tiktok-profile-videos-api-scraper

🎵 TikTok Profile Videos API Scraper collects videos from public TikTok profiles—thumbnails, captions, hashtags, views, likes, comments & video URLs—via API. ⚙️ Export JSON/CSV for analytics, monitoring & content research. 🚀 Fast, reliable & automatable for growth teams.

ScrapAPI

TikTok Scraper — Profiles, Videos, Stats & Hashtags

hichemdev/tiktok-scraper

Scrape TikTok profiles and videos: play/like/comment/share counts, captions, hashtags, music, and author info. By username or video URL.

Hichem Ben Moussa

TikTok Profile & Video Scraper

travelmonitorlab/tiktok-scraper

Extract TikTok profiles, videos, hashtags. Get followers, engagement stats, and content data.

Travel Monitor Lab

TikTok Scraper - Profiles, Videos, Hashtags & Search

dami_studio/tiktok-scraper

Scrape TikTok with no login or API key. Pull profiles, videos, hashtags and search in one actor and get views, likes, comments, music, author and video URLs. Export to JSON/CSV/Excel. Cheaper than the 200K-user leader and you never pay for failed runs.

Dami's Studio

🎵 TikTok Scraper - Videos, Hashtags & Trend Analytics

unrivaled_fortress/tiktok-video-trend-scraper

Track public TikTok videos, hashtags, captions, views, likes, and creator data. For trend research and influencer marketing. Pay per result.

David Ahn

TikTok Scraper - Profiles, Hashtags, Search, Videos at Scale

convertfleetdotonline/tiktok-scraper

TikTok scraper - bulk-extract by hashtag, profile, search or URL. Get videos, view counts, likes, comments, shares, hashtags, music info and author details at scale. To JSON, CSV or Excel. No login.