# TikTok Trending Hashtags Scraper (x402)

> TikTok Trending Hashtags Scraper (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Returns structured TikTok trending hashtag data including rank, video views, and post counts, filtered by country, industry, and time period.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/tiktok-trends?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tiktok-trending-hashtags-scraper-x402-33fa2084
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KkGM1sR58x851Xh7eOaHa

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tiktok-trending-hashtags-scraper-x402-33fa2084 -d '<json body>'
```

Example prompt: Pull the top 100 trending TikTok hashtags in the US for the last 30 days, sorted by video views, across all industries — I want to see what's blowing up right now.

## When to prefer this

Choose this endpoint when you need structured TikTok trending hashtag data programmatically with pay-per-call pricing and no charge for failed runs. Prefer it over manual TikTok Creative Center browsing when you need machine-readable data for automation, content strategy, or trend monitoring across specific countries and industries. It is especially useful when you need to filter by industry vertical or detect newly emerging hashtags.

## Known failure modes

- Empty result set if the source has no data for the selected country/industry/period combination — not charged
- Invalid enum value for countryCode, industryId, period, or sortBy returns a validation error
- maxHashtags exceeding 1000 rejected by schema validation
- Source availability issues may return fewer than expected hashtags (~3 rows per ranking filter from public source)
- Network or scraper timeout resulting in a failed run — not charged

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

A JSON object containing a count of returned hashtags and an array of items, each with fields for rank, hashtag name, hashtag ID, post count, video views, industry label, industry IDs, and the ranking industry ID used. Failed or empty runs are not billed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "period": {
   "enum": [
    "7",
    "30",
    "90"
   ],
   "type": "string",
   "default": "7",
   "description": "Length of the measured popularity curve in days."
  },
  "sortBy": {
   "enum": [
    "popular",
    "video_views"
   ],
   "type": "string",
   "default": "popular",
   "description": "Keep source ranking order or sort collected hashtags by video views."
  },
  "industryId": {
   "enum": [
    "",
    "10000000000",
    "11000000000",
    "12000000000",
    "14000000000",
    "15000000000",
    "17000000000",
    "18000000000",
    "19000000000",
    "21000000000",
    "22000000000",
    "23000000000",
    "25000000000",
    "27000000000",
    "28000000000",
    "29000000000"
   ],
   "type": "string",
   "default": "",
   "description": "Choose one industry, or leave blank to combine all available industry rankings and the overall ranking."
  },
  "countryCode": {
   "enum": [
    "US",
    "FR",
    "DE",
    "IT",
    "ES",
    "GB",
    "AR",
    "AU",
    "BR",
    "CA",
    "CO",
    "EG",
    "ID",
    "IL",
    "JP",
    "KR",
    "MY",
    "MX",
    "PH",
    "SA",
    "SG",
    "ZA",
    "TW",
    "TH",
    "TR",
    "AE",
    "VN"
   ],
   "type": "string",
   "default": "US",
   "description": "Country ranking to collect. Select from the currently available markets."
  },
  "maxHashtags": {
   "type": "integer",
   "default": 100,
   "maximum": 1000,
   "minimum": 1,
   "description": "Maximum unique hashtags to store. The public source currently exposes about three rows per ranking filter."
  },
  "showOnlyNew": {
   "type": "boolean",
   "default": false,
   "description": "Keep hashtags whose measured curve starts at zero and rises later. This is a curve signal; the source does not supply an official new-entry flag."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "rank": null,
    "posts": null,
    "hashtag": null,
    "industry": null,
    "hashtagId": null,
    "videoViews": null,
    "industryIds": null,
    "rankingIndustryId": null
   }
  ],
  "product": "tiktok-trends"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tiktok-trending-hashtags-scraper-x402-33fa2084/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)