# TikTok Hashtag Data Lookup

> TikTok Hashtag Data Lookup is a paid API for AI agents from api.portalsprotocol.com, paid per call via x402, $0.14/call, status unknown (last checked 2026-09-13).

Fetches TikTok posts, metadata, and engagement data associated with a given hashtag via a paid POST endpoint.

## Facts

- Endpoint: POST https://api.portalsprotocol.com/tiktok/hashtag
- Price: $0.14/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-portalsprotocol-com-b918b268
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eLdMJkO95qsdUPrmLzbae

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 api-portalsprotocol-com-b918b268 -d '<json body>'
```

Example prompt: Pull the TikTok hashtag data for #sustainability — I want to see the videos, view counts, and engagement stats associated with that tag.

## When to prefer this

Use this endpoint when you need to programmatically retrieve TikTok video content and engagement data for a specific hashtag — ideal for trend research, influencer analysis, campaign monitoring, or social listening on TikTok. Prefer this over manual TikTok browsing or other social APIs when TikTok-specific hashtag-level data is needed and you are comfortable with x402 micropayment billing.

## Known failure modes

- Hashtag not found or no content returns empty result set
- Invalid or malformed hashtag input returns 400 error
- TikTok rate limiting or API changes cause upstream failure
- Payment failure via x402 protocol returns 402 Payment Required
- Private or restricted hashtags may return no data

## How this service works

Fetch real-time TikTok hashtag details and metrics (posts, views, trending content) for a specified tag.

## Output

Returns a collection of TikTok posts associated with the queried hashtag, including video metadata such as video IDs, descriptions, author info, like/comment/share counts, view counts, and other engagement metrics tied to the hashtag.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-portalsprotocol-com-b918b268/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.portalsprotocol.com](https://www.zero.xyz/host/api.portalsprotocol.com/llms.txt)