# Search TikTok Videos by Keyword

**Use case:** 

Find TikTok videos by keyword and export creators, captions, hashtags, views, likes, comments, shares, sounds, and posting times.

## Input

```json
{
  "mode": "keywordVideos",
  "handles": [
    "@tiktok",
    "@nba"
  ],
  "keywords": [
    "small business tips",
    "summer fashion"
  ],
  "videosPerProfile": 50,
  "videoUrls": [
    "https://www.tiktok.com/@tiktok/video/7106594312292453675"
  ],
  "maxResults": 20,
  "maxProviderSpendUsd": 2,
  "includeRawResults": true,
  "includeReport": true,
  "historyDatasetName": "tiktok-creator-intelligence-history",
  "maxConcurrency": 1
}
```

## Output

```json
{
  "authorUsername": {
    "label": "Creator",
    "format": "text"
  },
  "caption": {
    "label": "Caption",
    "format": "text"
  },
  "views": {
    "label": "Views",
    "format": "number"
  },
  "likes": {
    "label": "Likes",
    "format": "number"
  },
  "comments": {
    "label": "Comments",
    "format": "number"
  },
  "shares": {
    "label": "Shares",
    "format": "number"
  },
  "engagementRatePct": {
    "label": "Engagement %",
    "format": "number"
  },
  "outlierScore": {
    "label": "Outlier score",
    "format": "number"
  },
  "isViral": {
    "label": "Viral outlier",
    "format": "boolean"
  },
  "videoUrl": {
    "label": "Video",
    "format": "link"
  },
  "scrapedAt": {
    "label": "Scraped",
    "format": "date"
  }
}
```

## About this Actor

This example demonstrates how to use [TikTok Creator & Competitor Intelligence](https://apify.com/scrape-lads/tiktok-scraper) with a specific input configuration. Visit the [Actor detail page](https://apify.com/scrape-lads/tiktok-scraper) to learn more, explore other use cases, and run it yourself.