---
description: Discover trending hashtags ranked by engagement with optional keyword filtering via semantic search. Use when the user asks about popular hashtags.
allowed-tools: Bash(curl *)
---

# Trending Hashtags

Discover trending hashtags ranked by engagement. Supports keyword-based semantic search to find hashtags related to a specific topic.

User's request: $ARGUMENTS

## API Call

```bash
curl -s "https://api.verosight.com/v1/analytics/hashtags?days=7&limit=10" \
  -H "X-API-Key: ${user_config.api_key}"
```

**Parameters:**
- `days` — period 1-90 (default 7)
- `limit` — max results (default 20)
- `platform` — filter: x, instagram, tiktok, etc.
- `keyword` — optional, find hashtags in topic-relevant posts via semantic search
- `media_type` — filter: image, video, text, article (photo is alias for image)
- `exclude_profiles` — comma-separated profiles to exclude
- `exclude_keywords` — comma-separated keywords to exclude

Parse the user's request:
- "trending hashtags about fashion" → keyword=fashion
- "popular hashtags on tiktok" → platform=tiktok
- "hashtags related to AI this month" → keyword=AI, days=30

## Output Format

For each hashtag: name, post count, total engagement, average engagement per post.

Show credits used (3 per call).