TikTok

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

The TikTok endpoint allows you find all TikTok ads for a given company.

It takes a company domain as input.

Company domain has to be passed in the 'company.com' format, meaning all prefixes like 'https://' or 'www.' need to be removed.

API endpoint

POST api.adyntel.com/tiktok

See which TikTok ads a company is running by providing their website as input.

Headers

Name	Value	Required
Content-Type	application/json

Body

Name	Type	Description	Required
api_key	string	Adyntel API key
email	string	Adyntel account email
company_domain	string	Company website. It has to be the brand's own domain, tiktok.com is rejected.
influencer_ads	boolean	Also returns the influencers posting sponsored content for the brand, each with a sample ad. Warning: this costs one extra credit on top of the credit for the scrape itself, so a call with influencer_ads costs two credits.
webhook_url	string	Webhook URL where the data will be returned. With a webhook the call answers immediately with a job id and the ads are POSTed to your URL when the scrape finishes. Without one the ads come back in the response to your call.
continuation_tokens	object	Tokens used to grab the next set of ads. You receive them in the response to your first call, and you send them back on the next call to get the following page: {"brand_ads": "<token>", "influencers": {"<handle>": "<token>"}}. The last page comes back with a null token.

If the company runs no TikTok ads, the endpoint answers with a 204 and an empty body.

The influencers key is only present in the response when you pass influencer_ads: true.

Example request

Request using company domain

{
    "api_key": "hd-nndgi7gy6b3kdsgd-a",
    "email": "[e-mail]",
    "company_domain": "gymshark.com"
}

Request including the influencer ads

{
    "api_key": "hd-nndgi7gy6b3kdsgd-a",
    "email": "[e-mail]",
    "company_domain": "gymshark.com",
    "influencer_ads": true
}

Request using a webhook

{
    "api_key": "hd-nndgi7gy6b3kdsgd-a",
    "email": "[e-mail]",
    "company_domain": "gymshark.com",
    "webhook_url": "your_webhook_url"
}

When you use a webhook the call answers straight away and the ads are sent to your URL:

{
    "status": "job started",
    "jobId": "4a9edbbc-abcf-44b0-8e3d-ceef332db44a"
}

Example response

{
    "handle": "gymshark",
    "brand_ads": [
        {
            "aweme_id": "7661334167342320918",
            "url": "https://www.tiktok.com/@gymshark/video/7661334167342320918",
            "posted_at": 1783793370,
            "desc": "Onyx V1 Returns. July 16th. 7pm BST | 2pm EDT | 8pm CEST #onyxv1 #onyx #davidlaid #Gymshark ",
            "is_ad": true,
            "ad_source": 1,
            "bc_type": 0,
            "stats": {
                "play_count": 1577611,
                "digg_count": 242881,
                "comment_count": 1030,
                "share_count": 9118,
                "collect_count": 17384,
                "download_count": 1051
            },
            "music": {
                "title": "original sound - gymshark",
                "is_commerce_music": true,
                "is_original_sound": true
            },
            "anchors": [],
            "shop_product_url": null,
            "region": "GB",
            "duration": null
        }
    ],
    "influencers": [
        {
            "handle": "llivsole",
            "uid": "7582680501585527863",
            "nickname": "LIV",
            "bio": "sweat, smiles, and your fav playlist",
            "follower_count": 0,
            "aweme_count": 0,
            "total_favorited": 0,
            "trust_tier": "paid_disclosed",
            "bc_type": 1,
            "discovered_via": "#gymsharkpartner",
            "sample_ad": {
                "aweme_id": "7683197142659271950",
                "url": "https://www.tiktok.com/@llivsole/video/7683197142659271950",
                "posted_at": 1788883747,
                "desc": "I am in looove with this color AND it's cotton, use code LLIV10 at checkout for 10% off your order!! @Gymshark #gymshark #gymsharkpartner #ad ",
                "is_ad": false,
                "ad_source": null,
                "bc_type": 1,
                "stats": {
                    "play_count": 10317,
                    "digg_count": 192,
                    "comment_count": 12,
                    "share_count": 7,
                    "collect_count": 21,
                    "download_count": 1
                },
                "music": {
                    "title": "Yukon x Up hunnybee",
                    "is_commerce_music": true,
                    "is_original_sound": true
                },
                "anchors": [],
                "shop_product_url": null,
                "region": "US",
                "duration": null
            }
        }
    ],
    "continuation_tokens": {
        "brand_ads": "1787940000001",
        "influencers": {
            "gymsharkpartner": "20"
        }
    },
    "cache": {
        "hit": false,
        "age_s": 0
    }
}