---
title: "Get ad details"
method: GET
path: "/tiktok/ads/details"
tags: ["TikTok API"]
---

# Get ad details

`GET /tiktok/ads/details`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/tiktok/ads/details`
- Auth: API key in header `X-API-KEY`

Resolve a TikTok Creative Center ad URL into ad metadata.

## Query parameters

- `url` string, required

## Response `200`

- object
  - `code` integer, required
  - `msg` string, required
  - `processed_time` number, required
  - `data` object, required
    - `ad_id` string, required
    - `brand_name` string, required
    - `industry` string, required
    - `objective` string, required
    - `video_url` string, required
    - `cover` string, required
    - `like_count` integer, required
    - `comment_count` integer, required
    - `share_count` integer, required
    - `cta` string, required
    - `destination` string, required

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `422`: Validation error

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/1e1aa78ff103?raw)