Adyntel Documentation
  • 🤖Welcome!
  • Authorization
  • Ad Libraries
    • Meta
    • Meta ad search
    • LinkedIn
    • Google
    • Google shopping
    • Google shopping status
    • TikTok search
    • TikTok ad details
    • Paid vs organic keywords
  • Clay
    • Connecting to Clay
    • Extracting LinkedIn page id
  • Frequently Asked Questions
    • Billing
    • Contact
Powered by GitBook
On this page
  • API endpoint
  • Headers
  • Body
  • Example request
  • Example response
  1. Ad Libraries

TikTok ad details

PreviousTikTok searchNextPaid vs organic keywords

Last updated 1 month ago

You first need to create an account, you can sign up to receive 50 credits to test it out.

The TikTok endpoint allows you to see all the details of a specific ad.

This endpoint needs an "id" that you get in the response from the endpoint.

API endpoint

POST api.adyntel.com/tiktok_ad_details

Get all the details for an ad on TikTok using the ad id as the starting point.

Headers

Name
Value
Required

Content-Type

application/json

Body

Name
Type
Description
Required

api_key

string

Adyntel API key

email

number

Adyntel account email

id

number

Ad id

Example request

You can get the ID from the response you receive from the TikTok search endpoint.

{
    "api_key": "hd-nndgi7gy6b3kdsgd-a",
    "email": "elon@tesla.com",
    "id": "1816440843906114"
}

Example response

{
    "code": 0,
    "data": {
        "ad": {
            "audit_status": "1",
            "estimated_audience": "100K-200K",
            "first_shown_date": 1732665600000,
            "id": "1816831112281202",
            "image_urls": [
                "https://p21-ad-sg.ibyteimg.com/origin/tos-alisg-p-0051c001-sg/ok3dA3fBoE9pmOzBhXRLlosyGAwAui9SiD07Iw"
            ],
            "impression": 0,
            "last_shown_date": 1733702400000,
            "name": "elevateshoes",
            "rejection_info": null,
            "show_mode": 1,
            "sor_audit_status": "1",
            "spent": "",
            "type": "2",
            "videos": [
                {
                    "cover_img": "https://p21-ad-sg.ibyteimg.com/origin/tos-alisg-p-0051c001-sg/ok3dA3fBoE9pmOzBhXRLlosyGAwAui9SiD07Iw",
                    "video_url": "https://library.tiktok.com/api/v1/cdn/1734464111/video/aHR0cHM6Ly92MTZtLnRpa3Rva2Nkbi5jb20vMTdlOThhMDI5NzA0YTE0YTFjY2U1NGVhMzI5MjExNjUvNjc2MjI3MDkvdmlkZW8vdG9zL2FsaXNnL3Rvcy1hbGlzZy12ZS0wMDUxYzAwMS1zZy9vd0hFd2k5UW05M0l6QVhmR2xMb0p5eFBkczlCQkFpN29oYUEyTy8=/ed57d125-b946-4379-8694-22c1c56f77be?a=475769&bti=PDU2NmYwMy86&ch=0&cr=0&dr=1&cd=0%7C0%7C0%7C0&cv=1&br=2126&bt=1063&cs=0&ds=1&ft=.NpOcInz7Thejh8OXq8Zmo&mime_type=video_mp4&qs=0&rc=Zzs2NTlnNTU1OjVmNDpkZ0BpamZ2cXc5cnc4dzMzODYzNEAzY2MuNWBiXjMxMy5gNDZjYSMycWJkMmRzcTBgLS1kMC1zcw%3D%3D&vvpl=1&l=20241217193509589C44FCF926E6EC3DFA&btag=e00088000&cc=3"
                }
            ]
        },
        "advertiser": {
            "adv_biz_ids": "7401666423417765905",
            "name": "elevateshoes",
            "registry_location": "Germany",
            "sponsor": "elevateshoes",
            "tt_user": null
        },
        "targeting": {
            "age": [
                {
                    "13-17": false,
                    "18-24": true,
                    "25-34": true,
                    "35-44": true,
                    "45-54": true,
                    "55+": true,
                    "region": "AT"
                },
                {
                    "13-17": false,
                    "18-24": true,
                    "25-34": true,
                    "35-44": true,
                    "45-54": true,
                    "55+": true,
                    "region": "DE"
                }
            ],
            "audience": "No",
            "creator_interactions": "",
            "gender": [
                {
                    "female": true,
                    "male": true,
                    "region": "AT",
                    "unknown": true
                },
                {
                    "female": true,
                    "male": true,
                    "region": "DE",
                    "unknown": true
                }
            ],
            "interest": "",
            "location": {
                "data": [
                    {
                        "impressions": "27K",
                        "region": "AT"
                    },
                    {
                        "impressions": "116K",
                        "region": "DE"
                    }
                ],
                "total_impressions": "100K-200K",
                "total_region": 2
            },
            "target_audience_size": "21.9M-26.8M",
            "video_interactions": ""
        }
    }
}
here
TikTok search