Search top-performing TikTok Creative Center ads

GET/v1/ads/top/ads10 Credits / ad (min 10 Credits)($1.00 / 1K ads)

Query top-performing commercial ads from TikTok Creative Center (data.materials), filtered by country, time window, and ranking metric (impression, ctr, like).

Query Parameters

country_codestring
Two-letter country code (US, GB, CA, DE, JP, etc.).
Example: US
periodinteger
Time range in days (7, 30, or 180).
Example: 7
order_bystring
Ranking metric: impression, ctr, or like.
Example: impression
pageinteger
Page number (starts at 1).
Example: 1
limitinteger (1 to 20)
Ads per page (max 20).
Example: 20

Example Request (cURL / Python / JavaScript)

curl "https://api.shortvidapi.com/v1/ads/top/ads" \
  -H "x-api-key: tk_your_api_key"

Live Response Preview

{
  "code": 0,
  "provider": "https://shortvidapi.com",
  "status": "ok",
  "msg": "success",
  "data": {
    "pagination": {
      "has_more": true,
      "page": 1,
      "size": 5,
      "total_count": 31
    },
    "materials": [
      {
        "ad_title": "Up to 50% OFF! Clip Studio Paint is on sale now until October 15, 8:00 am (GMT)",
        "brand_name": "",
        "cost": 1,
        "ctr": 0.05,
        "favorite": false,
        "id": "7683023815559315476",
        "industry_key": "label_20110000000",
        "is_search": true,
        "like": 1252,
        "objective_key": "campaign_objective_traffic",
        "video_info": {
          "vid": "v14033g50000dagfil7og65n0u801vn0",
          "duration": 53.547,
          "cover": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/oke2IMKHccp0d1kBfHFSQFAeAALVGqAfgDGQAI~tplv-noop.image?dr=18692&refresh_token=e649a007&x-expires=1793567657&x-signature=QJgVIVuRbkogtf235hpl%2FLqC3JM%3D&t=927...",
          "video_url": {
            "1080p": "https://v16m-default.tiktokcdn.com/7a9cb116e33a64d0adfc2397cb618116/6ae7aba9/video/tos/alisg/tos-alisg-ve-0051c001-sg/oAEPgQVIGh2tyCltAIecAVgg8Lf9NVDGMKKbRf/?a=0&bti=NTU4QDM1NGA%3D&&bt=1032&ft=cApXJCz7ThWH-mF8LGZmo0P&mim..."
          },
          "width": 1080,
          "height": 1920
        }
      },
      {
        "ad_title": "Up to 50% OFF! Clip Studio Paint is on sale now until October 15, 8:00 am (GMT)",
        "brand_name": "",
        "cost": 1,
        "ctr": 0.05,
        "favorite": false,
        "id": "7683021402580942868",
        "industry_key": "label_20110000000",
        "is_search": true,
        "like": 719,
        "objective_key": "campaign_objective_traffic",
        "video_info": {
          "vid": "v14033g50000dagfil7og65rtkgdl760",
          "duration": 77.27,
          "cover": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/ocO3eqAdfAB9AkDUDVjBl2QgGFNQPoO11UEIBY~tplv-noop.image?dr=18692&refresh_token=7cc5d10e&x-expires=1793567681&x-signature=U44%2BJkhXzz6Re2B77RdTDz6hEl4%3D&t=927...",
          "video_url": {
            "1080p": "https://v16m-default.tiktokcdn.com/0468aede766225662615ec28e7212298/6ae7abc1/video/tos/alisg/tos-alisg-ve-0051c001-sg/oIOseAGPEJpD5LbFVyR5cBgGAgKfCyfRiTQyIQ/?a=0&bti=NTU4QDM1NGA%3D&&bt=2605&ft=cApXJCz7ThWH-mF8LGZmo0P&mim...",
            "360p": "https://v16m-default.tiktokcdn.com/2d4c871dee4081babf0a877ba7b14e73/6ae7abc1/video/tos/alisg/tos-alisg-ve-0051c001-sg/oQWg5IHcfoqAiwQkZ6EuBFnDNB7DZgOQCQfkoI/?a=0&bti=NTU4QDM1NGA%3D&&bt=389&ft=cApXJCz7ThWH-mF8LGZmo0P&mime...",
            "480p": "https://v16m-default.tiktokcdn.com/cc45a463c5c89cde7de3c023a2491778/6ae7abc1/video/tos/alisg/tos-alisg-ve-0051c001-sg/ooQBnnZAc5CDpZo2gKmN7cfODIBFfkEqgQiIoZ/?a=0&bti=NTU4QDM1NGA%3D&&bt=561&ft=cApXJCz7ThWH-mF8LGZmo0P&mime...",
            "540p": "https://v16m-default.tiktokcdn.com/939cdd82439563d966136e8bb5835cec/6ae7abc1/video/tos/alisg/tos-alisg-ve-0051c001-sg/ogADA2RffyVReCEdQ5GyQg5kgPJbIcLAHyFGEy/?a=0&bti=NTU4QDM1NGA%3D&&bt=771&ft=cApXJCz7ThWH-mF8LGZmo0P&mime...",
            "720p": "https://v16m-default.tiktokcdn.com/83fca92341598c4d3dad7719a6f0bfc7/6ae7abc1/video/tos/alisg/tos-alisg-ve-0051c001-sg/oQ5BVocf0f1qFBAoQO7iNkIDgEMDQmgZZCnKIs/?a=0&bti=NTU4QDM1NGA%3D&&bt=1150&ft=cApXJCz7ThWH-mF8LGZmo0P&mim..."
          },
          "width": 720,
          "height": 1280
        }
      }
    ]
  }
}

Response Fields

Success (code === 0). Charged according to the endpoint credit rate.

Field	Type	Sample / Notes
`code`	integer	Example: 0
`provider`	string	Example: https://shortvidapi.com
`status`	string	Example: ok
`msg`	string	Example: success
`data`	object
`pagination`	object
`has_more`	boolean	Example: true
`page`	integer	Example: 1
`size`	integer	Example: 5
`total_count`	integer	Example: 31
`materials`	array of object
`ad_title`	string	Example: Up to 50% OFF! Clip Studio Paint is on sale now until Octobe
`brand_name`	string	Example:
`cost`	integer	Example: 1
`ctr`	number	Example: 0.05
`favorite`	boolean	Example: false
`id`	string	Example: 7683023815559315476
`industry_key`	string	Example: label_20110000000
`is_search`	boolean	Example: true
`like`	integer	Example: 1252
`objective_key`	string	Example: campaign_objective_traffic
`video_info`	object

Status Codes

200: Success (code === 0). Charged according to the endpoint credit rate.
400: Invalid parameters, or API key placed in the URL query string (not charged).
401: Missing or invalid x-api-key header (not charged).
402: Insufficient credit balance (not charged).
403: Account disabled (not charged).
404: Unknown endpoint or disabled unstable endpoint (not charged).
405: Method not allowed — all /v1/* data endpoints use GET (not charged).
429: Rate limit exceeded (not charged). Respect the Retry-After header.
503: Temporary upstream or gateway error (not charged). Retry with exponential backoff.

Migrating from direct scraping and hitting HTTP 403 Forbidden or empty responses on www.tiktok.com? Read How to Fix TikTok HTTP Error 403 or compare quota limits in our TikTok API Quota & Cost Calculator.