Actions46
- Videos Actions
- Users Actions
- Hashtags Actions
- Music Actions
- Analytics Actions
- Marketing/Ads Actions
- Business Actions
- Creator Actions
- Commerce/Shopping Actions
Analytics → Get Hashtag Analytics
AI-generatedOverview
This node provides enhanced integration with TikTok's API via the N8N Tools service, enabling access to a wide range of TikTok data and analytics. Specifically, for the Analytics > Get Hashtag Analytics operation, it retrieves detailed analytical data about a specified hashtag over a defined date range.
Use cases include:
- Monitoring the performance and reach of specific hashtags on TikTok.
- Analyzing trends and engagement metrics related to marketing campaigns or content strategies involving hashtags.
- Gathering data to inform social media strategy by understanding hashtag popularity and user interaction over time.
Example: A social media manager wants to track how a branded hashtag performed during a campaign period. By specifying the hashtag and the start/end dates, they can obtain analytics such as views, shares, and engagement metrics for that hashtag.
Properties
| Name | Meaning |
|---|---|
| Hashtag | The name of the hashtag to analyze (without the # symbol). |
| Start Date | The start date for the analytics data in YYYY-MM-DD format. |
| End Date | The end date for the analytics data in YYYY-MM-DD format. |
Output
The node outputs JSON data containing the analytics information for the specified hashtag within the given date range. This typically includes metrics such as:
- Total views
- Engagement statistics (likes, shares, comments)
- Growth trends over the selected period
- Other relevant hashtag performance indicators provided by TikTok's analytics API
The exact structure depends on TikTok's API response but is returned as a JSON object under the json field of each output item.
No binary data output is produced by this operation.
Dependencies
- Requires an active subscription and valid API key credential for the N8N Tools API service.
- Requires TikTok API credentials configured in N8N to authorize requests.
- The node internally validates the API key with the N8N Tools API before making TikTok API calls.
- Network connectivity to both N8N Tools API and TikTok API endpoints is necessary.
Troubleshooting
- Invalid subscription or API key error: If you receive an error indicating invalid subscription or API key, verify that your API key credential is correct and has the necessary permissions.
- Date format issues: Ensure that the
Start DateandEnd Dateare provided in the correctYYYY-MM-DDformat; otherwise, the TikTok API may reject the request. - Hashtag not found or no data: If the hashtag does not exist or has insufficient data for the specified date range, the output may be empty or contain minimal information.
- API rate limits: Excessive requests may lead to throttling by TikTok or N8N Tools API. Implement appropriate delays or batch processing.
- Network errors: Check network connectivity if requests fail due to timeouts or unreachable endpoints.
Links and References
- TikTok for Developers - Analytics API
- N8N Documentation - Creating Custom Nodes
- N8N Tools API Service (for subscription and API key management)