TikTok Ads Scraper API

With our dedicated Tiktok Ads Scraper API, you can scrape Ads listings from TikTok.

Each successful request will cost you 5 API credits.

You have to send a GET request to http://api.scrapingdog.com/tiktok/ads with the below-given parameters.

Parameters

Scrapingdog Parameters

Parameter
Description

api_key

required

Your personal API key. Available on your dashboard Type: String

Search Query

Parameter
Description

query

The keyword you want to search for on TikTok Ads. Type: String

advertiser_id

The unique advertiser ID to search for ads from specific advertiser. Type: String

Geographic Location and Localization

Parameter
Description

country

The parameter specifies the country you want to search from. Default Value: all Type - String

Filters

Parameter
Description

time_period

Defines the date range for ad results. Enter a custom range in YYYY-MM-DD..YYYY-MM-DD format.

If no range is provided, results from the past 12 months are returned by default. Type - String

sort_by

Defines how the ad results should be sorted. Supported values:

  • last_shown_date_newest_to_oldest

  • last_shown_date_oldest_to_newest

  • published_date_newest_to_oldest

  • published_date_oldest_to_newest

  • unique_users_seen_low_to_high

  • unique_users_seen_high_to_low

Default Value: last_shown_date_newest_to_oldest Type: String

query_type

Specifies how the search query should be interpreted when fetching TikTok ads. Supported values: 1 - Searches ads by keyword or text query. Use this when you want to find ads related to a specific brand name, product, topic, or phrase. 2 - Searches ads by advertiser. Use this when the query is intended to match advertiser-related results instead of general ad keywords. Default Value: 1 Type: String

Pagination

Parameter
Description

next_page_token

The next_page_token is used to get the next page of results. Type: String

API Example

API Response

Last updated