TikTok

Search public TikTok posts by keyword, hashtag or creator and get plays, likes, comments, shares and saves per post, with author stats and an engagement summary.

POST/v1/social/tiktok/search

Search

Returns posts and totals for the query. Keyword searches return the most relevant recent videos; hashtag and profile searches return the most recent posts.

Costs 0.6 credits per post, rounded to the nearest half credit. 20 posts is 11.5 credits.

Required attributes

Name
query
Type
string
Description
A keyword, a hashtag without #, or a username without @, depending on type.

Optional attributes

Name
type
Type
string
Description
keyword, hashtag or profile. Default keyword.
Name
posts
Type
integer
Description
Posts to fetch, 5 to 50. Default 20. Capped by your plan.

Response fields

Name
totals.engagement_rate_pct
Type
number
Description
Likes plus comments plus shares, divided by plays, as a percentage.
Name
posts[].is_ad
Type
boolean
Description
Whether the post is labelled as sponsored.
Name
posts[].author.followers
Type
integer
Description
The creator's follower count at the time of the call.

Request

POST

/v1/social/tiktok/search

curl -X POST https://suvjexogmfpvxjcktvuk.supabase.co/functions/v1/api/v1/social/tiktok/search \
  -H "Authorization: Bearer $PENGU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "protein powder", "type": "keyword", "posts": 20}'

Response

{
  "data": {
    "query": "protein powder",
    "type": "keyword",
    "checked_at": "2026-09-09T11:43:59.758Z",
    "count": 5,
    "totals": {
      "plays": 4471583,
      "likes": 257699,
      "comments": 2218,
      "shares": 52659,
      "engagement_rate_pct": 6.99
    },
    "posts": [
      {
        "url": "https://www.tiktok.com/@seannalewanyj/video/7672427397106453780",
        "text": "Literally one of the highest quality sources of protein on the planet by the way. P.S. DM “WHEY” and I’ll send...",
        "posted_at": "2026-08-10T15:36:56.000Z",
        "is_ad": false,
        "duration_seconds": 32,
        "plays": 87000,
        "likes": 5528,
        "comments": 185,
        "shares": 150,
        "saves": 246,
        "hashtags": [
          "fitness",
          "bodybuilding",
          // ...
        ],
        "author": {
          "username": "seannalewanyj",
          "name": "seannalewanyj",
          "followers": 683800,
          "verified": true
        }
      },
      {
        "url": "https://www.tiktok.com/@yestojules/video/7680186917157145886",
        "text": "Best overall - Puori PW1 Best US whey - Promix Whey Isolate Best for athletes - Momentous Whey Protein Isolate...",
        "posted_at": "2026-08-31T13:28:24.000Z",
        "is_ad": true,
        "duration_seconds": 101,
        "plays": 8883,
        "likes": 433,
        "comments": 41,
        "shares": 76,
        "saves": 349,
        "hashtags": [
          "healthylongevity",
          "proteinpowder",
          // ...
        ],
        "author": {
          "username": "yestojules",
          "name": "yestojules",
          "followers": 28100,
          "verified": false
        }
      },
      // ...
    ]
  },
  "meta": {
    "credits_charged": 11.5,
    "credits_remaining": 483.5,
    "request_id": "1fe9e439-91df-4c23-a33d-14e488a2c693"
  }
}