# Find TikTok Conversion Ads From This Week

**Use case:** 

Find TikTok ads associated with conversion campaigns in the global leaderboard for the past 7 days. Results include ad titles, brand names, CTR, like counts, and video download URLs. Change the country, period, or maximum number of ads to adapt the results.

## Input

```json
{
  "mode": "leaderboard",
  "country": "US",
  "period": "7",
  "industry": "",
  "objective": "campaign_objective_conversion",
  "language": "",
  "adFormat": "",
  "likeTier": "",
  "orderBy": "for_you",
  "maxItems": 20,
  "sweep": false,
  "includeDetails": false,
  "includeKeyframes": false,
  "adIds": []
}
```

## Output

```json
{
  "adId": {
    "label": "Ad ID",
    "format": "text"
  },
  "adTitle": {
    "label": "Ad Title",
    "format": "text"
  },
  "brandName": {
    "label": "Brand",
    "format": "text"
  },
  "ctr": {
    "label": "CTR",
    "format": "number"
  },
  "like": {
    "label": "Likes",
    "format": "number"
  },
  "industryName": {
    "label": "Industry",
    "format": "text"
  },
  "objectiveName": {
    "label": "Objective",
    "format": "text"
  },
  "foundInCountry": {
    "label": "Market",
    "format": "text"
  },
  "observedPeriod": {
    "label": "Period (days)",
    "format": "number"
  },
  "landingPageUrl": {
    "label": "Landing Page",
    "format": "link"
  },
  "creativeCenterUrl": {
    "label": "Creative Center",
    "format": "link"
  },
  "scrapedAt": {
    "label": "Scraped At",
    "format": "text"
  }
}
```

## How it works

### 1. Sign up on Apify or log in

The TikTok Top Ads Leaderboard - 122 Markets & Metrics Actor is ready to run with the inputs already set for "Find TikTok Conversion Ads From This Week". [Sign up or log in](https://console.apify.com/create-task-from-example/YdekuNrRx9omEdvkL) and you'll land in Apify Console with a copy of this exact task.

### 2. Start the "Find TikTok Conversion Ads From This Week" task

The TikTok Top Ads Leaderboard - 122 Markets & Metrics Actor will start running based on the input automatically. You can also change all the input fields, like mode, country, and more, to match your specific use case.

### 3. Receive the "Find TikTok Conversion Ads From This Week" output

Monitor the progress in real time. You will be notified as soon as your dataset is complete and ready for review. Each result includes data such as ad id, ad title, brand, and more.

### 4. Integrate into your workflow

The final output is delivered in JSON, CSV, or Excel format, ready to be plugged into your workflow. You can also [run the "Find TikTok Conversion Ads From This Week" task via API](https://apify.com/nimbryxo-studio/tiktok-top-ads-leaderboard-by-country.md).

## FAQ

### What data can I get about TikTok conversion ads this week?

The TikTok conversion ads task returns leaderboard ads with titles, brand names, CTR, like counts, video details, and ad links. The overview includes each ad’s country and period when available.

### How do I find the best TikTok conversion ads this week?

The TikTok conversion ads task uses the global leaderboard for the past 7 days, filtered to conversion campaigns and ranked by TikTok’s recommendation score. You can change the period or ranking method.

### How much does it cost to get TikTok ad results?

For the TikTok conversion ads task’s 20-result limit, the result charge is at most $0.02 on the Free plan. Actor start events cost $0.10 on Free, with additional Apify platform compute usage.

### Can I run TikTok ad collection on a schedule or through an API?

You can run the TikTok conversion ads task on an Apify Schedule, through the Apify API, or with integrations such as Zapier, Make, and n8n.

### How do I change the country or time period for TikTok ad data?

Use Try for free to copy the TikTok conversion ads task into your Apify account with the same input, then change its settings. The actor supports one country per run, or an empty country for all countries, and periods of 7, 30, or 180 days.

## About this Actor

This example demonstrates how to use [TikTok Top Ads Leaderboard - 122 Markets & Metrics](https://apify.com/nimbryxo-studio/tiktok-top-ads-leaderboard-by-country.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/nimbryxo-studio/tiktok-top-ads-leaderboard-by-country.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

This Task's input is already configured above. Use it as-is rather than inventing a new one.

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 full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/nimbryxo-studio/tiktok-top-ads-leaderboard-by-country.md

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