# TikTok hashtag details by tag name — challenge id

TikTok hashtag metadata — resolves a tag name to the challengeID needed for hashtag videos

by TikHub Ready to run $0.0025 per request · $0.25 per 100 requests

## Example

### You ask your agent

“How popular is #coffee on TikTok?”

### You get

**Share meta title:** #coffee on TikTok

**Description:** Watch awesome short videos created with trending hashtag #coffee

**View count:** 201,500,000,000

**Video count:** 0

**Stats v2 view count:** 201530941282

**Stats v2 video count:** 23329221

**Challenge title:** coffee

**Challenge description:** We're celebrating International Coffee Day! Share your favourite coffee hacks, recommendations and stories with us!

**What your agent sends and gets back (JSON)**

Your agent works out the exact inputs, such as IDs, dates and settings, from what you ask.

### Request

```
{
  "tool_id": "tikhub.tiktok-hashtag-detail",
  "input": {
    "tag_name": "coffee"
  }
}
```

### Response

```
{
  "data": {
    "shareMeta": {
      "desc": "Watch awesome short videos created with trending hashtag #coffee",
      "title": "#coffee on TikTok"
    },
    "challengeInfo": {
      "stats": {
        "viewCount": 201500000000,
        "videoCount": 0
      },
      "statsV2": {
        "viewCount": "201530941282",
        "videoCount": "23329221"
      },
      "challenge": {
        "id": "14104",
        "desc": "We're celebrating International Coffee Day! Share your favourite coffee hacks, recommendations and stories with us!",
        "stats": {
          "viewCount": 201500000000,
          "videoCount": 0
        },
        "title": "coffee"
      }
    }
  }
}
```

## Use it with your agent

Copy the prompt and paste it into your agent, then tell it what you need.

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use TikTok hashtag details by tag name — challenge id (tool ID: tikhub.tiktok-hashtag-detail). Ask me for the details you need, then show me the result.

Provider access is included. If your agent isn't connected to Scrollport yet, it will help you set that up.

## Other tools for this job

[Compare all 23 →](https://scrollport.com/tools/tiktok-api)

- [Search TikTok across all content by keyword](https://scrollport.com/tools/providers/tikhub/tiktok-app-v3-fetch-general-search-result) TikHub $0.0025 per request $0.0025 per request
- [Search TikTok hashtags by keyword](https://scrollport.com/tools/providers/tikhub/tiktok-app-v3-fetch-hashtag-search-result) TikHub $0.0025 per request $0.0025 per request
- [Search TikTok photo posts by keyword](https://scrollport.com/tools/providers/tikhub/tiktok-web-fetch-search-photo) TikHub $0.0025 per request $0.0025 per request

## Questions

**Is TikTok hashtag details by tag name — challenge id (TikHub) free?**

Scrollport has no free tier: it costs $0.0025 per request ($0.25 per 100 requests), paid per use from a prepaid wallet with no subscription. Connecting your first agent adds $1 of trial credit, so you can try it before adding funds.

**Do I need an API key from TikHub?**

No. Your agent runs it through your Scrollport connection (MCP, the Scrollport CLI or the HTTP API), and Scrollport handles access to TikHub, so you don't sign up with TikHub or manage an API key.

## Details

**About this tool**

TikTok hashtag metadata — resolves a tag name to the challengeID needed for hashtag videos Retrieve one bounded result or page. Pagination is explicit; each follow-up page is another call. The catalog price is the maximum per request. Quotes use the selected limits. Completed requests cost their quote, including valid empty pages and no-match answers. Failed requests are uncharged. Read public social data without a connected social account. Results include reviewed business data and available pagination. The worked example shows selected fields from a recorded response, with at most one selected item from each list.

**All inputs and outputs**

### Input

`tag_name` string · required

hashtag without the '#'

minLength: 1 · maxLength: 500

### Output

`data` object

Main result payload.

**Errors and limits**

- `invalid_input`: The lookup fields or limits are invalid.example: {"tag_name":"coffee"}
- `upstream_error`: The provider could not complete a verified result; the wallet was not charged.Check the documented fields and contact Scrollport support with the run ID if needed.

---

Canonical page: https://scrollport.com/tools/providers/tikhub/tiktok-hashtag-detail