# TikTok Trending Hashtags Scraper

> TikTok Trending Hashtags Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Returns structured trending hashtag data from TikTok's public rankings, filterable by country, industry, time period, and sort order.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/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-c90ff2ba
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3tPdcJ5HNCl2jomI_xCG-

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-c90ff2ba -d '<json body>'
```

Example prompt: What are the top 50 trending TikTok hashtags in the US right now for the beauty industry over the last 30 days, sorted by video views?

## When to prefer this

Use this endpoint when you need structured, ranked TikTok hashtag trend data filterable by country and industry without building your own scraper. Prefer it over generic social listening tools when you specifically need TikTok Creative Center ranking data with video view metrics and industry segmentation. Ideal for marketing automation agents that need fresh hashtag signals on demand.

## Known failure modes

- Empty result set if no hashtags match the filters (not charged)
- Invalid countryCode or industryId enum value returns an error
- maxHashtags exceeding 1000 is rejected by schema validation
- Network or scraping failure returns no data (not charged)
- TikTok public source may expose limited rows (~3 per ranking filter), constraining actual results

## How this service works

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

## Output

Returns a JSON object with a count and an array of hashtag items, each containing the hashtag text, hashtag ID, rank, post count, video views, associated industry, industry IDs, and the ranking industry ID used for that entry.

## 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-c90ff2ba/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)