# Find TikTok ads for a keyword

**Use case:** 

Search TikTok's Ad Library by keyword and country to see who's advertising in your niche and what creatives they're running.

## Input

```json
{
  "maxResults": 50,
  "fetchAdDetail": false,
  "downloadMedia": false,
  "startUrls": [
    {
      "url": "https://library.tiktok.com/ads?region=DE&adv_name=nike&sort_type=last_shown_date,desc"
    }
  ],
  "keywords": [
    {
      "query": "summer sale",
      "region": "DE",
      "searchAsAdvertiser": false,
      "sortOrder": "newest"
    }
  ]
}
```

## Output

```json
{
  "videos.0.cover_img": {
    "label": "Cover",
    "format": "image"
  },
  "id": {
    "label": "Ad ID",
    "format": "string"
  },
  "name": {
    "label": "Advertiser",
    "format": "string"
  },
  "type": {
    "label": "Creative type",
    "format": "string"
  },
  "estimated_audience": {
    "label": "Audience size",
    "format": "string"
  },
  "first_shown_date": {
    "label": "First shown",
    "format": "integer"
  },
  "last_shown_date": {
    "label": "Last shown",
    "format": "integer"
  },
  "region": {
    "label": "Region",
    "format": "string"
  },
  "source_url": {
    "label": "Source",
    "format": "string"
  }
}
```

## About this Actor

This example demonstrates how to use [TikTok Ad Library - Free To Use](https://apify.com/dz_omar/tiktok-ad-library-scraper) with a specific input configuration. Visit the [Actor detail page](https://apify.com/dz_omar/tiktok-ad-library-scraper) to learn more, explore other use cases, and run it yourself.