When should an agent use the TikTok hashtag videos node?

You are researching trends, creators or product buzz on TikTok. It is not meant for downloading videos or collecting follower lists. A call usually takes about 15 seconds.

What does the TikTok hashtag videos node return?

Get 10 TikTok videos for any hashtag with caption, views, likes, shares, comments, music and creator as JSON. Spot trends and product buzz in one call. Each call returns 10 videos: caption, hashtags, views, likes, shares, saves, comment count, music, creator, date and link.

How much does one call cost?

$0.043 in USDC on Base per search (up to 10 videos) (one call = up to 10 videos), charged only when it succeeds. No sign-up, subscription or API key.

What happens if the call fails?

You are not charged. TollNode checks your signed payment first, runs the node, and only collects the payment if the result is usable. A failed, empty or timed-out call is never settled, so there is nothing to refund.

How does an AI agent pay?

With x402. The first request returns HTTP 402 and the exact price. Any x402 wallet signs the USDC payment and retries automatically. In Claude Code or Cursor, run npx agentcash add https://tollnode.com once.

Can I use an API key instead?

Yes. Create a free account, add funds in USDC on Base, create an API key and send it as Authorization: Bearer. Each successful call is deducted from your balance at the same price; failed calls cost nothing.

Illustration: a phone screen with a music note and a hash sign

TikTok hashtag videos

Get 10 TikTok videos for any hashtag with caption, views, likes, shares, comments, music and creator as JSON. Spot trends and product buzz in one call.

POST /api/v1/nodes/tiktok-hashtag

Price

$0.043

per search (up to 10 videos)

One call gets you up to 10 videos. You only pay when it works: if a call fails, it costs nothing.

Use it from your AI assistant

Paste this once into Claude Code, Cursor or Codex. After that, just ask, for example: “what are people on Reddit saying about this product?”. Your assistant finds this node and pays for it by itself.

connect TollNode (one time)

npx agentcash add https://tollnode.com

For developers: call it directly

terminal

npx agentcash@latest fetch https://tollnode.com/api/v1/nodes/tiktok-hashtag -m POST -b '{"hashtag":"skincare"}'

Is this the right node?

Use it when: You are researching trends, creators or product buzz on TikTok.
Not for: Downloading videos or collecting follower lists.
You get: 10 videos: caption, hashtags, views, likes, shares, saves, comment count, music, creator, date and link.
Typical time: About 15 seconds per call

How it works

Your agent pays for itself

Explained in 5 minutes →

1Needs something
2Finds it on TollNode
3Pays a few cents
4Gets the result

Two ways to use TikTok hashtag videos

Way 1 · Pay per call (x402)

For AI agents, no sign-up

Your agent sends the request, gets a 402 with the exact price ($0.043 per search (up to 10 videos)), signs a USDC payment on Base and retries. Nothing is collected unless the call succeeds.

add TollNode to Claude Code, Cursor or Codex (once)

npx agentcash add https://tollnode.com

or call it directly

npx agentcash@latest fetch https://tollnode.com/api/v1/nodes/tiktok-hashtag -m POST -b '{"hashtag":"skincare"}'

Way 2 · Account + API key

For apps and teams

Create a free account, load a balance with USDC on Base, create an API key and call any node. Same prices; each successful call is deducted from your balance.

curl

curl -X POST https://tollnode.com/api/v1/nodes/tiktok-hashtag \
  -H "Authorization: Bearer $TOLLNODE_API_KEY" \
  -H "content-type: application/json" \
  -d '{"hashtag":"skincare"}'

Step-by-step, with code in JavaScript and Python: full guide for TikTok hashtag videos.

Input

Field	Type	Notes
hashtag*	string	Hashtag without #, e.g. skincare

Example response

{
  "results": [
    {
      "id": "7694767250527571222",
      "isAd": true,
      "text": "post everything shower routine 🫧🧼 #skincare #beauty \n•\n@rhode skin cleanser \n@Diorbeauty eye patches \n@Skinfood Tha…",
      "isStory": false,
      "hashtags": [
        {
          "id": null,
          "name": "skincare",
          "cover": null,
          "title": null
        }
      ],
      "isPinned": false,
      "mentions": [
        "@rhode skin"
      ],
      "diggCount": 83300,
      "playCount": 455400,
      "videoMeta": {
        "width": 576,
        "format": "mp4",
        "height": 1024,
        "coverUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-no1a-p-0037-no/ooAepLwRAhEjFGfjIeTLjaASD5IIkVmIAAFJEh~tplv-tiktokx-origi…",
        "duration": 64,
        "definition": "540p",
        "subtitleLinks": null,
        "aiVideoSummary": null,
        "originalCoverUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-no1a-p-0037-no/ooAepLwRAhEjFGfjIeTLjaASD5IIkVmIAAFJEh~tplv-tiktokx-origi…",
        "transcriptionLink": null,
        "aiVideoDescription": null
      },
      "createTime": 1791577619,
      "shareCount": 1039,
      "isSlideshow": false,
      "isSponsored": false,
      "repostCount": 0,
      "webVideoUrl": "https://www.tiktok.com/@darceyangel/video/7694767250527571222",
      "collectCount": 6839,
      "commentCount": 268,
      "textLanguage": "en",
      "createTimeISO": "2026-10-09T20:26:59.000Z",
      "hasTikTokShopProduct": false,
      "shortDramaSeriesInfo": null
    }
  ]
}

FAQ

When should an agent use the TikTok hashtag videos node?: You are researching trends, creators or product buzz on TikTok. It is not meant for downloading videos or collecting follower lists. A call usually takes about 15 seconds.
What does the TikTok hashtag videos node return?: Get 10 TikTok videos for any hashtag with caption, views, likes, shares, comments, music and creator as JSON. Spot trends and product buzz in one call. Each call returns 10 videos: caption, hashtags, views, likes, shares, saves, comment count, music, creator, date and link.
How much does one call cost?: $0.043 in USDC on Base per search (up to 10 videos) (one call = up to 10 videos), charged only when it succeeds. No sign-up, subscription or API key.
What happens if the call fails?: You are not charged. TollNode checks your signed payment first, runs the node, and only collects the payment if the result is usable. A failed, empty or timed-out call is never settled, so there is nothing to refund.
How does an AI agent pay?: With x402. The first request returns HTTP 402 and the exact price. Any x402 wallet signs the USDC payment and retries automatically. In Claude Code or Cursor, run npx agentcash add https://tollnode.com once.
Can I use an API key instead?: Yes. Create a free account, add funds in USDC on Base, create an API key and send it as Authorization: Bearer. Each successful call is deducted from your balance at the same price; failed calls cost nothing.