ProvlyDocs

Search docs

Guides and API endpoints

DocsAPI referenceNetworksTikTok ads

TikTok ads

GET/api/v1/tiktok/ads

GET /ads locked to TikTok (Creative Center top ads and TikTok advertisers).

Bearer API keyMCP tool search_ads

Query parameters

querystring

Keywords matched in ad copy, headline, transcript and brand name.

formatsstring[]

Creative formats.

videoimagecarouseldcodpa
nichesstring[]

Niche slugs; see GET /facets/niches.

fashionbeauty-carehealth-supplementshome-gardenfood-drinkelectronics-techsports-outdoorspet-suppliesbaby-parentingtoys-gamesarts-hobbiesgifts-eventsbooks-educationtravel-luggageautomotivebusiness-industrialappsother
countriesstring[]

ISO 3166-1 alpha-2 country codes the ad targets.

languagesstring[]

Ad languages (ISO 639-1).

activeboolean

true for ads still running, false for stopped ones.

min_running_daysinteger

Minimum days the ad has run. 30+ usually means a profitable ad.

domainstring

Landing-page domain.

advertiser_idstring

Only this advertiser's ads (ids come from /lookup).

sortstring

Order of results. Defaults to most_relevant with a query, else newest.

newestoldestlongest_runningmost_relevant
limitintegerdefault 20

Results per page, 1–50.

cursorstring

The next_cursor of the previous page.

Try it

GET/api/v1/tiktok/ads?query=collagen&countries=TR%2CDE&min_running_days=30&domain=gymshark.com
curl "https://provly.co/api/v1/tiktok/ads?query=collagen&countries=TR%2CDE&min_running_days=30&domain=gymshark.com" \
  -H "Authorization: Bearer $PROVLY_API_KEY"
200 · Response
{
  "data": [
    {
      "id": "meta_library_1203944578113742",
      "advertiser": {
        "id": "meta_library_104587213",
        "name": "Pawfect Co."
      },
      "platforms": [
        "tiktok"
      ],
      "format": "video",
      "headline": "The self-cleaning litter box cats love",
      "body": "No scooping for 14 days. 30-day money-back guarantee.",
      "cta": "Shop now",
      "landing_url": "https://pawfect.co/products/autobox",
      "is_active": true,
      "started_at": "2026-07-02T00:00:00.000Z",
      "ended_at": null,
      "running_days": 86,
      "countries": [
        "TR",
        "DE"
      ],
      "languages": [
        "tr"
      ],
      "niches": [
        "pet-supplies"
      ],
      "media": {
        "image": null,
        "video": "https://media.provly.co/meta/1203944578113742.mp4",
        "thumbnail": "https://media.provly.co/meta/1203944578113742.jpg",
        "video_duration": 27
      },
      "reach": 184200,
      "engagement": null,
      "duplicates": 6,
      "transcript": "Tired of scooping every day? …",
      "provly_url": "https://provly.co/app?ad=meta_library_1203944578113742"
    }
  ],
  "pagination": {
    "total": 1284,
    "next_cursor": "eyJzIjpbMTcy…"
  }
}