trendHERO Platform Help
Helps the user with trendHERO platform questions — from influencer discovery and fake follower detection through audience analysis, tracking, ads database research, and API integration.
Step 1 — Gather context
If references/learnings.md exists, read it first for accumulated knowledge.
Ask the user:
What do you need help with?
- A) Finding influencers — Discovery search, filters, keyword search
- B) Analyzing a creator — AQS score, fake follower detection, audience quality
- C) Tracking — daily monitoring of influencer accounts
- D) Ads database — researching influencer ad posts and mentions
- E) Audience overlap — comparing audiences across influencers
- F) Outreach — contacting influencers through trendHERO
- G) Lists — organizing and comparing influencers
- H) API integration — generating reports programmatically
- I) Pricing and plan selection
- J) Something else — describe it
What's your current setup?
- A) New to trendHERO — evaluating or just signed up
- B) Using trendHERO for discovery/analytics
- C) Using trendHERO for tracking and monitoring
- D) Integrating via API
- E) Comparing trendHERO to other platforms
What plan are you on?
- A) Free ($0/mo)
- B) Lite ($16/mo)
- C) Pro ($40/mo)
- D) Advanced ($120/mo)
- E) Not sure / evaluating
If the user's request already provides most of this context, skip directly to the relevant step. Lead with your best-effort answer using reasonable assumptions (stated explicitly), then ask only the most critical 1-2 clarifying questions at the end.
Step 2 — Route or answer directly
If the request maps to a strategy skill, route:
- Influencer marketing strategy across platforms →
/sales-influencer-marketing
- TikTok marketing strategy →
/sales-tiktok-marketing
- Gaming influencer marketing →
/sales-gaming-marketing
- Ad campaign strategy →
/sales-retargeting or /sales-b2b-advertising
- Email marketing to subscribers →
/sales-email-marketing
- Affiliate program design →
/sales-affiliate-program
Otherwise, answer directly from the platform reference below.
Step 3 — trendHERO platform reference
Platform overview
trendHERO is an Instagram-focused influencer analytics platform specializing in fake follower detection and audience quality analysis. It provides a database of 95M+ Instagram profiles with 90+ metrics per creator, making it a focused, affordable tool for brands and agencies vetting influencers before partnerships.
Core modules
Influencer Discovery
- Database: 95M+ Instagram profiles (TikTok analytics recently added)
- Search methods: Keyword search in names and bios (required and negative keywords), audience demographic filters (geo, age, gender), engagement metrics (followers, ER, growth), category/niche filtering
- 20+ filters including audience location, category, engagement rate, follower count range
- Relevance ranking: Results ranked by keyword match density in profile name and bio
- Results: Searchable database with list-saving capability
Account Quality Score (AQS)
- Scale: 1-100 (higher = better quality)
- 5 evaluation dimensions:
- Audience quality & engagement — authenticity and activity level of followers
- Follower type — classification of audience composition (real, suspicious, mass followers)
- Comment quality — analysis of engagement patterns (generic vs. authentic comments)
- Giveaway activity — frequency of promotional giveaways (inflates metrics temporarily)
- Growth patterns — historical follower acquisition trends (organic vs. purchased)
- Purpose: Rapid 2-second overall account health assessment — consolidates multiple red flags into one score
Analytics Reports (90+ metrics)
- Engagement: Median likes/comments per post (uses median to eliminate outliers from viral posts), views per reel (unique views, not play count), weekly post frequency
- Audience: Demographics (age, gender, location, language), audience type breakdown (real, suspicious, mass followers), reachability (% of followers following <1,500 accounts)
- Growth: Followers/followings growth tracking over time, growth pattern analysis
- Benchmarks: Comments-to-likes ratio (0.5–5 per 100 likes), views-to-likes ratio (2–10 views per like)
- Export: PDF and Excel download
Daily Tracking
- Monitor influencer accounts daily for follower growth, engagement changes, and content activity
- Track competitors' influencer partnerships
- Alerts for significant changes (follower spikes, engagement drops)
- Plan-gated: Lite = 3 accounts, Pro = 20, Advanced = 50
Ads Database
- 10M+ ad posts — database of influencer-brand mentions and sponsored content
- Research which influencers are working with which brands
- Discover competitors' influencer partnerships
- Filter by brand, influencer, date range, engagement metrics
Audience Overlap
- Compare audiences across multiple influencers
- Identify unique reach vs. shared followers
- Optimize influencer selection for maximum reach (minimize overlap)
- Essential for multi-influencer campaigns
Lists & Comparison
- Create lists to organize influencer candidates
- Side-by-side comparison of key metrics
- Export lists for team review
- Favorites/shortlisting functionality
Outreach
- Built-in influencer outreach tools
- Contact influencers directly through the platform
- Track outreach status and responses
Pricing
Best-effort — verify with trendHERO for current pricing.
| Plan |
Price |
Reports/mo |
Tracking |
Lists |
Key features |
| Free |
$0/mo |
— |
— |
Favorites only |
Engagement rate, follower growth, basic metrics |
| Lite |
$16/mo |
10 |
3 accounts |
10 lists |
Full reports, PDF export |
| Pro |
$40/mo |
50 |
20 accounts |
Unlimited |
Excel export, full search across 95M+ profiles |
| Advanced |
$120/mo |
200 |
50 accounts |
Unlimited |
Priority support, all features |
- Additional reports can be purchased as add-ons
- All paid plans include AQS scoring and audience analysis
- Free plan provides basic engagement data — useful for quick checks
Plan-gated features to watch
- Full influencer search (95M+ database) — Pro+ only (Lite has limited search)
- Excel export — Pro+ only (Lite only has PDF)
- Tracking limits — Lite: 3 accounts, Pro: 20, Advanced: 50
- Report limits — credits consumed per report, varies by plan
- Priority support — Advanced only
Metrics reference
| Metric |
What it measures |
Calculation method |
| Likes/post |
Typical like volume |
Median of last 18 posts (excludes most recent if <1 day old) |
| Comments/post |
Comment engagement |
Same median methodology |
| Views/reel |
Unique video views |
Unique views (not Instagram play count — ratio up to 5:1) |
| Weekly posts |
Content consistency |
Average posts per week over analyzed period |
| Engagement rate |
Audience interaction % |
(Likes + comments) / followers × 100 |
| Reachability |
Addressable audience % |
% of followers following <1,500 accounts |
| AQS |
Overall account quality |
Composite of 5 dimensions (1-100 scale) |
Step 4 — Actionable guidance
Based on the user's specific question, provide:
- Discovery playbook — how to set up searches, keyword strategies, filter combinations for their niche
- Vetting workflow — how to read AQS scores, what score ranges mean, red flags to watch
- Tracking setup — which accounts to monitor, how to interpret growth alerts
- Ads database research — how to find competitor influencer partnerships
- Audience overlap analysis — how to optimize multi-influencer campaigns for reach
- API integration — authentication, endpoints, webhook setup, processing times
- Plan recommendation — which tier fits their needs and budget
For API integration questions, refer to the detailed trendHERO API Reference.
Gotchas
Best-effort from research — review these, especially items about plan-gated features and integration gotchas that may be outdated.
Reports consume credits, not just time. Each analytics report uses one credit from your monthly allocation. Running reports on influencers you end up rejecting still costs credits. Vet with free metrics (engagement rate, follower growth) before spending a report credit on a full AQS analysis.
Report generation can be slow for large accounts. Accounts with 1M+ followers can take 2-4 hours to generate. Smaller accounts (<10K) take 30-60 minutes. Already-cached accounts return instantly. Plan ahead for time-sensitive vetting.
Instagram-focused with limited multi-platform coverage. trendHERO's 95M+ database is primarily Instagram. TikTok analytics were recently added but with less depth. If you need YouTube, X, or Twitch coverage, consider HypeAuditor or Modash.
Free plan is very limited. Only basic engagement rate and follower growth — no AQS, no full reports, no search. Useful for a quick check but not for serious vetting. Lite ($16/mo) is the minimum for actionable analytics.
Median-based metrics can surprise you. trendHERO uses median (not average) for likes and comments to eliminate viral post outliers. This gives a more realistic picture of typical performance but may show lower numbers than you expect if you're used to average-based tools.
Reachability metric is unique and important. The "% of followers following <1,500 accounts" metric indicates how likely your content is to actually appear in followers' feeds. Low reachability means the influencer's followers follow so many accounts that your sponsored post may not be seen.
API has no documented rate limits. The API docs don't specify rate limits, but report generation is inherently throttled by processing time. For batch operations, implement reasonable delays between requests.
Webhook requires setup in the Access Tokens page. The API supports webhook callbacks when reports finish processing, but you must configure the webhook URL in your account settings — it's not set per-request.
Self-improving: If you discover something not covered here, append it to references/learnings.md with today's date.
Related skills
/sales-influencer-marketing — Influencer marketing strategy across all platforms — discovery, vetting, campaigns, ROI
/sales-hypeauditor — HypeAuditor platform help — AI-powered influencer analytics, 223.6M+ profiles, fraud detection, Campaign Management, API
/sales-heepsy — Heepsy platform help — budget-friendly influencer discovery, 11M+ profiles, Shopify integration
/sales-modash — Modash platform help — Shopify-focused discovery, gifting, payments, API
/sales-infludata — influData platform help — AI creator search, audience analysis, social listening
/sales-tiktok-marketing — TikTok marketing strategy — organic growth, paid ads, content creation, influencer strategy
/sales-gaming-marketing — Gaming influencer marketing strategy — streamers, game launches
/sales-do — Not sure which skill to use? The router matches any sales objective to the right skill. Install: npx skills add sales-skills/sales --skill sales-do
Examples
Example 1: Vet an influencer before a paid partnership
User says: "A fitness influencer with 80K followers wants $1,200 for a post — how do I check if they're legit?"
Skill does:
- Shows how to search for the creator by username in trendHERO
- Explains how to read the AQS score — what ranges indicate good quality (>60), concerning (<40), or deal-breaker (<25)
- Walks through the 5 AQS dimensions: audience type, comment quality, growth patterns, giveaway history
- Highlights reachability metric — what % of their followers will actually see the post
- Compares the $1,200 ask to their actual authentic reach and engagement
Result: Data-driven decision on whether the partnership is worth the investment
Example 2: Research competitor influencer partnerships
User says: "I want to see which influencers my competitors are working with"
Skill does:
- Shows how to use the Ads Database to search by brand/competitor name
- Explains filtering by date range, engagement metrics, and influencer size
- Demonstrates how to identify which creators drive the best engagement for competitors
- Suggests saving interesting creators to a list for further analysis
- Recommends running AQS reports on shortlisted creators before outreach
Result: Competitive intelligence on influencer partnerships with actionable next steps
Example 3: Set up API integration for batch influencer reports
User says: "I want to pull influencer analytics into our internal tool via the trendHERO API"
Skill does:
- Walks through API authentication: Bearer token from Access Tokens page
- Shows the POST endpoint to create a report:
POST /reports?username={username}
- Explains async processing — reports aren't instant, check status field for
ready vs collecting
- Demonstrates webhook setup for completion notifications
- Shows GET endpoint to retrieve completed reports:
GET /reports/{username}
- Points to the API reference for full endpoint documentation
Result: Working API integration plan with auth, endpoints, and async handling
Troubleshooting
Report takes hours to generate
Symptom: Requested a report but it's still in "collecting" status after 30+ minutes
Cause: Large accounts (1M+ followers) require more data processing. First-time reports for uncached accounts take longer.
Solution: Check if the account has been analyzed before — previously cached accounts return instantly. For large accounts, allow up to 2-4 hours. Use the API webhook to get notified when the report is ready instead of polling manually. If a report is stuck beyond 4 hours, the account may be private or have restricted data access — check for impossible status.
AQS score seems too low for a legitimate creator
Symptom: A creator you know is legitimate has an AQS below 40
Cause: AQS factors in giveaway history and growth patterns. Creators who run frequent giveaways or had rapid growth spurts (even organic ones from viral content) may get penalized.
Solution: Don't rely on AQS alone — check individual dimensions. If audience type and comment quality are high but giveaway activity is dragging the score down, the creator may still be a good partner. Cross-reference with engagement rate and reachability metrics for a complete picture.
Running out of report credits too fast
Symptom: Monthly report allocation exhausted before finding enough qualified influencers
Cause: Running full reports on every potential influencer without pre-screening wastes credits.
Solution: Use free metrics first — check engagement rate and follower growth on the free plan or in search results before spending a credit on a full report. Create a pre-screening checklist: engagement rate >2%, steady growth pattern, relevant content. Only run full AQS reports on influencers that pass the free-metric screen. Consider upgrading to Pro (50 reports) or Advanced (200 reports) if you regularly need more.
1---2name: sales-trendhero3description: trendHERO platform help — Instagram influencer analytics (95M+ profiles, 20+ filters), Account Quality Score (AQS 1-100, fake follower detection), Audience Analysis, Daily Tracking, Ads Database (10M+ posts), Audience Overlap, REST API (Bearer auth, webhooks). Covers discovery search, AQS interpretation, audience vetting, tracking setup, ads database research, API integration, and pricing (Free/Lite/Pro/Advanced). Use when you suspect an influencer has fake followers, trendHERO search results aren't matching your niche, you need to monitor an influencer's metrics over time, you want to see which influencers your competitors are using, the trendHERO API isn't working as expected, you're unsure which trendHERO plan fits your budget, or you're deciding between trendHERO, HypeAuditor, and Heepsy. Do NOT use for influencer strategy across platforms (use /sales-influencer-marketing), TikTok marketing (use /sales-tiktok-marketing), gaming influencer marketing (use /sales-gaming-marketing), or ad campaigns (use /sale4license: MIT5---6
7# trendHERO Platform Help
8
9Helps the user with trendHERO platform questions — from influencer discovery and fake follower detection through audience analysis, tracking, ads database research, and API integration.
10
11## Step 1 — Gather context
12
13
14If `references/learnings.md` exists, read it first for accumulated knowledge.
15
16Ask the user:
17
181. **What do you need help with?**
19 - A) Finding influencers — Discovery search, filters, keyword search
20 - B) Analyzing a creator — AQS score, fake follower detection, audience quality
21 - C) Tracking — daily monitoring of influencer accounts
22 - D) Ads database — researching influencer ad posts and mentions
23 - E) Audience overlap — comparing audiences across influencers
24 - F) Outreach — contacting influencers through trendHERO
25 - G) Lists — organizing and comparing influencers
26 - H) API integration — generating reports programmatically
27 - I) Pricing and plan selection
28 - J) Something else — describe it
29
302. **What's your current setup?**
31 - A) New to trendHERO — evaluating or just signed up
32 - B) Using trendHERO for discovery/analytics
33 - C) Using trendHERO for tracking and monitoring
34 - D) Integrating via API
35 - E) Comparing trendHERO to other platforms
36
373. **What plan are you on?**
38 - A) Free ($0/mo)
39 - B) Lite ($16/mo)
40 - C) Pro ($40/mo)
41 - D) Advanced ($120/mo)
42 - E) Not sure / evaluating
43
44**If the user's request already provides most of this context, skip directly to the relevant step.** Lead with your best-effort answer using reasonable assumptions (stated explicitly), then ask only the most critical 1-2 clarifying questions at the end.
45
46## Step 2 — Route or answer directly
47
48If the request maps to a strategy skill, route:
49- Influencer marketing strategy across platforms → `/sales-influencer-marketing`
50- TikTok marketing strategy → `/sales-tiktok-marketing`
51- Gaming influencer marketing → `/sales-gaming-marketing`
52- Ad campaign strategy → `/sales-retargeting` or `/sales-b2b-advertising`
53- Email marketing to subscribers → `/sales-email-marketing`
54- Affiliate program design → `/sales-affiliate-program`
55
56Otherwise, answer directly from the platform reference below.
57
58## Step 3 — trendHERO platform reference
59
60### Platform overview
61
62trendHERO is an Instagram-focused influencer analytics platform specializing in fake follower detection and audience quality analysis. It provides a database of 95M+ Instagram profiles with 90+ metrics per creator, making it a focused, affordable tool for brands and agencies vetting influencers before partnerships.
63
64### Core modules
65
66#### Influencer Discovery
67- **Database**: 95M+ Instagram profiles (TikTok analytics recently added)
68- **Search methods**: Keyword search in names and bios (required and negative keywords), audience demographic filters (geo, age, gender), engagement metrics (followers, ER, growth), category/niche filtering
69- **20+ filters** including audience location, category, engagement rate, follower count range
70- **Relevance ranking**: Results ranked by keyword match density in profile name and bio
71- **Results**: Searchable database with list-saving capability
72
73#### Account Quality Score (AQS)
74- **Scale**: 1-100 (higher = better quality)
75- **5 evaluation dimensions**:
76 1. Audience quality & engagement — authenticity and activity level of followers
77 2. Follower type — classification of audience composition (real, suspicious, mass followers)
78 3. Comment quality — analysis of engagement patterns (generic vs. authentic comments)
79 4. Giveaway activity — frequency of promotional giveaways (inflates metrics temporarily)
80 5. Growth patterns — historical follower acquisition trends (organic vs. purchased)
81- **Purpose**: Rapid 2-second overall account health assessment — consolidates multiple red flags into one score
82
83#### Analytics Reports (90+ metrics)
84- **Engagement**: Median likes/comments per post (uses median to eliminate outliers from viral posts), views per reel (unique views, not play count), weekly post frequency
85- **Audience**: Demographics (age, gender, location, language), audience type breakdown (real, suspicious, mass followers), reachability (% of followers following <1,500 accounts)
86- **Growth**: Followers/followings growth tracking over time, growth pattern analysis
87- **Benchmarks**: Comments-to-likes ratio (0.5–5 per 100 likes), views-to-likes ratio (2–10 views per like)
88- **Export**: PDF and Excel download
89
90#### Daily Tracking
91- Monitor influencer accounts daily for follower growth, engagement changes, and content activity
92- Track competitors' influencer partnerships
93- Alerts for significant changes (follower spikes, engagement drops)
94- *Plan-gated*: Lite = 3 accounts, Pro = 20, Advanced = 50
95
96#### Ads Database
97- **10M+ ad posts** — database of influencer-brand mentions and sponsored content
98- Research which influencers are working with which brands
99- Discover competitors' influencer partnerships
100- Filter by brand, influencer, date range, engagement metrics
101
102#### Audience Overlap
103- Compare audiences across multiple influencers
104- Identify unique reach vs. shared followers
105- Optimize influencer selection for maximum reach (minimize overlap)
106- Essential for multi-influencer campaigns
107
108#### Lists & Comparison
109- Create lists to organize influencer candidates
110- Side-by-side comparison of key metrics
111- Export lists for team review
112- Favorites/shortlisting functionality
113
114#### Outreach
115- Built-in influencer outreach tools
116- Contact influencers directly through the platform
117- Track outreach status and responses
118
119### Pricing
120
121*Best-effort — verify with trendHERO for current pricing.*
122
123| Plan | Price | Reports/mo | Tracking | Lists | Key features |
124|---|---|---|---|---|---|
125| **Free** | $0/mo | — | — | Favorites only | Engagement rate, follower growth, basic metrics |
126| **Lite** | $16/mo | 10 | 3 accounts | 10 lists | Full reports, PDF export |
127| **Pro** | $40/mo | 50 | 20 accounts | Unlimited | Excel export, full search across 95M+ profiles |
128| **Advanced** | $120/mo | 200 | 50 accounts | Unlimited | Priority support, all features |
129
130- Additional reports can be purchased as add-ons
131- All paid plans include AQS scoring and audience analysis
132- Free plan provides basic engagement data — useful for quick checks
133
134### Plan-gated features to watch
135
136- **Full influencer search (95M+ database)** — Pro+ only (Lite has limited search)
137- **Excel export** — Pro+ only (Lite only has PDF)
138- **Tracking limits** — Lite: 3 accounts, Pro: 20, Advanced: 50
139- **Report limits** — credits consumed per report, varies by plan
140- **Priority support** — Advanced only
141
142### Metrics reference
143
144| Metric | What it measures | Calculation method |
145|---|---|---|
146| Likes/post | Typical like volume | Median of last 18 posts (excludes most recent if <1 day old) |
147| Comments/post | Comment engagement | Same median methodology |
148| Views/reel | Unique video views | Unique views (not Instagram play count — ratio up to 5:1) |
149| Weekly posts | Content consistency | Average posts per week over analyzed period |
150| Engagement rate | Audience interaction % | (Likes + comments) / followers × 100 |
151| Reachability | Addressable audience % | % of followers following <1,500 accounts |
152| AQS | Overall account quality | Composite of 5 dimensions (1-100 scale) |
153
154## Step 4 — Actionable guidance
155
156Based on the user's specific question, provide:
157
1581. **Discovery playbook** — how to set up searches, keyword strategies, filter combinations for their niche
1592. **Vetting workflow** — how to read AQS scores, what score ranges mean, red flags to watch
1603. **Tracking setup** — which accounts to monitor, how to interpret growth alerts
1614. **Ads database research** — how to find competitor influencer partnerships
1625. **Audience overlap analysis** — how to optimize multi-influencer campaigns for reach
1636. **API integration** — authentication, endpoints, webhook setup, processing times
1647. **Plan recommendation** — which tier fits their needs and budget
165
166For API integration questions, refer to the detailed [trendHERO API Reference](references/trendhero-api-reference.md).
167
168## Gotchas
169
170*Best-effort from research — review these, especially items about plan-gated features and integration gotchas that may be outdated.*
171
172- **Reports consume credits, not just time.** Each analytics report uses one credit from your monthly allocation. Running reports on influencers you end up rejecting still costs credits. Vet with free metrics (engagement rate, follower growth) before spending a report credit on a full AQS analysis.
173- **Report generation can be slow for large accounts.** Accounts with 1M+ followers can take 2-4 hours to generate. Smaller accounts (<10K) take 30-60 minutes. Already-cached accounts return instantly. Plan ahead for time-sensitive vetting.
174- **Instagram-focused with limited multi-platform coverage.** trendHERO's 95M+ database is primarily Instagram. TikTok analytics were recently added but with less depth. If you need YouTube, X, or Twitch coverage, consider HypeAuditor or Modash.
175- **Free plan is very limited.** Only basic engagement rate and follower growth — no AQS, no full reports, no search. Useful for a quick check but not for serious vetting. Lite ($16/mo) is the minimum for actionable analytics.
176- **Median-based metrics can surprise you.** trendHERO uses median (not average) for likes and comments to eliminate viral post outliers. This gives a more realistic picture of typical performance but may show lower numbers than you expect if you're used to average-based tools.
177- **Reachability metric is unique and important.** The "% of followers following <1,500 accounts" metric indicates how likely your content is to actually appear in followers' feeds. Low reachability means the influencer's followers follow so many accounts that your sponsored post may not be seen.
178- **API has no documented rate limits.** The API docs don't specify rate limits, but report generation is inherently throttled by processing time. For batch operations, implement reasonable delays between requests.
179- **Webhook requires setup in the Access Tokens page.** The API supports webhook callbacks when reports finish processing, but you must configure the webhook URL in your account settings — it's not set per-request.
180
181- **Self-improving**: If you discover something not covered here, append it to `references/learnings.md` with today's date.
182
183## Related skills
184
185- `/sales-influencer-marketing` — Influencer marketing strategy across all platforms — discovery, vetting, campaigns, ROI
186- `/sales-hypeauditor` — HypeAuditor platform help — AI-powered influencer analytics, 223.6M+ profiles, fraud detection, Campaign Management, API
187- `/sales-heepsy` — Heepsy platform help — budget-friendly influencer discovery, 11M+ profiles, Shopify integration
188- `/sales-modash` — Modash platform help — Shopify-focused discovery, gifting, payments, API
189- `/sales-infludata` — influData platform help — AI creator search, audience analysis, social listening
190- `/sales-tiktok-marketing` — TikTok marketing strategy — organic growth, paid ads, content creation, influencer strategy
191- `/sales-gaming-marketing` — Gaming influencer marketing strategy — streamers, game launches
192- `/sales-do` — Not sure which skill to use? The router matches any sales objective to the right skill. Install: `npx skills add sales-skills/sales --skill sales-do`
193
194## Examples
195
196### Example 1: Vet an influencer before a paid partnership
197**User says**: "A fitness influencer with 80K followers wants $1,200 for a post — how do I check if they're legit?"
198**Skill does**:
1991. Shows how to search for the creator by username in trendHERO
2002. Explains how to read the AQS score — what ranges indicate good quality (>60), concerning (<40), or deal-breaker (<25)
2013. Walks through the 5 AQS dimensions: audience type, comment quality, growth patterns, giveaway history
2024. Highlights reachability metric — what % of their followers will actually see the post
2035. Compares the $1,200 ask to their actual authentic reach and engagement
204**Result**: Data-driven decision on whether the partnership is worth the investment
205
206### Example 2: Research competitor influencer partnerships
207**User says**: "I want to see which influencers my competitors are working with"
208**Skill does**:
2091. Shows how to use the Ads Database to search by brand/competitor name
2102. Explains filtering by date range, engagement metrics, and influencer size
2113. Demonstrates how to identify which creators drive the best engagement for competitors
2124. Suggests saving interesting creators to a list for further analysis
2135. Recommends running AQS reports on shortlisted creators before outreach
214**Result**: Competitive intelligence on influencer partnerships with actionable next steps
215
216### Example 3: Set up API integration for batch influencer reports
217**User says**: "I want to pull influencer analytics into our internal tool via the trendHERO API"
218**Skill does**:
2191. Walks through API authentication: Bearer token from Access Tokens page
2202. Shows the POST endpoint to create a report: `POST /reports?username={username}`
2213. Explains async processing — reports aren't instant, check status field for `ready` vs `collecting`
2224. Demonstrates webhook setup for completion notifications
2235. Shows GET endpoint to retrieve completed reports: `GET /reports/{username}`
2246. Points to the API reference for full endpoint documentation
225**Result**: Working API integration plan with auth, endpoints, and async handling
226
227## Troubleshooting
228
229### Report takes hours to generate
230**Symptom**: Requested a report but it's still in "collecting" status after 30+ minutes
231**Cause**: Large accounts (1M+ followers) require more data processing. First-time reports for uncached accounts take longer.
232**Solution**: Check if the account has been analyzed before — previously cached accounts return instantly. For large accounts, allow up to 2-4 hours. Use the API webhook to get notified when the report is ready instead of polling manually. If a report is stuck beyond 4 hours, the account may be private or have restricted data access — check for `impossible` status.
233
234### AQS score seems too low for a legitimate creator
235**Symptom**: A creator you know is legitimate has an AQS below 40
236**Cause**: AQS factors in giveaway history and growth patterns. Creators who run frequent giveaways or had rapid growth spurts (even organic ones from viral content) may get penalized.
237**Solution**: Don't rely on AQS alone — check individual dimensions. If audience type and comment quality are high but giveaway activity is dragging the score down, the creator may still be a good partner. Cross-reference with engagement rate and reachability metrics for a complete picture.
238
239### Running out of report credits too fast
240**Symptom**: Monthly report allocation exhausted before finding enough qualified influencers
241**Cause**: Running full reports on every potential influencer without pre-screening wastes credits.
242**Solution**: Use free metrics first — check engagement rate and follower growth on the free plan or in search results before spending a credit on a full report. Create a pre-screening checklist: engagement rate >2%, steady growth pattern, relevant content. Only run full AQS reports on influencers that pass the free-metric screen. Consider upgrading to Pro (50 reports) or Advanced (200 reports) if you regularly need more.