# TikTok Top Ads Ad

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/tiktoktopads/ad` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/tiktoktopads-ad |

## Description

Get one TikTok Creative Center Top Ad by URL or id: creative, landing page, CTR, and engagement (1 credit).

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/tiktoktopads/ad' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Crafted Elements creative

```json
{
  "ctr": 0.22,
  "url": "https://ads.tiktok.com/business/creativecenter/topads/7686267188656750612/pc/en?period=30",
  "cost": 1,
  "ad_id": "7686267188656750612",
  "format": "video",
  "source": "TikTok Ads Manager",
  "duration": 32.9,
  "headline": "25% Off Our Popular Juice Groove Router Jig. Limited Time Sale!",
  "countries": [
    "US"
  ],
  "image_url": "https://p16.tiktokcdn.com/detail-cover.jpg",
  "objective": "campaign_objective_conversion",
  "video_url": "https://v16.tiktokcdn.com/detail.mp4",
  "like_count": 39,
  "objectives": [
    {
      "label": "campaign_objective_conversion",
      "value": 3
    }
  ],
  "voice_over": null,
  "share_count": 1,
  "industry_key": "label_21103000000",
  "keyword_list": null,
  "landing_page": "https://craftedelements.com/products/juice-groove-router-jig",
  "comment_count": 0,
  "advertiser_name": "crafted elements"
}
```

## Documentation

## Overview
Read one creative from **TikTok Top Ads**. Pass the detail URL returned by search or the bare numeric material id. **1 credit** per call.

## Quickstart
```
GET https://api.piloterr.com/v2/tiktoktopads/ad?query=https://ads.tiktok.com/business/creativecenter/topads/7686267188656750612/pc/en?period=30
GET https://api.piloterr.com/v2/tiktoktopads/ad?query=7686267188656750612
```

## Related endpoints
- [TikTok Top Ads Search](https://www.piloterr.com/library/tiktoktopads-search)