Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.asteragents.com/llms.txt

Use this file to discover all available pages before exploring further.

​
What it does

The Search TikTok tool searches TikTok videos and comments for specific topics. Perfect for social media monitoring, trend analysis, influencer research, and understanding viral content patterns.

​
Key features

  • Search TikTok videos by keywords and hashtags
  • Filter by time periods (today to last 6 months)
  • Get video descriptions, view counts, likes, and comments
  • Include top comments for deeper engagement insights
  • Access creator information and video statistics

​
Parameters

ParameterTypeRequiredDescription
search_termstringYesThe term, hashtag, or phrase to search for
periodstringNoTime filter: “0” (today), “1” (24h), “7” (week), “30” (month), “90” (3 months), “180” (6 months) (default: “7”)
limitintegerNoNumber of videos to fetch, max 20 (default: 10)
include_commentsbooleanNoWhether to include top comments (default: true)

​
Common use cases

search_term: "#AI2024"
period: "7"
limit: 20
include_comments: true
Monitor what’s trending in AI and technology.

​
Brand monitoring

search_term: "your brand name"
period: "30"
limit: 15
include_comments: true
See what people are saying about your brand on TikTok.

​
Competitor analysis

search_term: "competitor brand"
period: "7"
limit: 20
include_comments: true
Monitor competitor mentions and sentiment.

​
Content inspiration

search_term: "#marketingtips"
period: "7"
limit: 15
include_comments: false
Find popular content ideas in your niche.

​
Influencer research

search_term: "fitness motivation"
period: "30"
limit: 20
include_comments: true
Discover influencers and popular content creators.

​
Crisis monitoring

search_term: "company name issue"
period: "1"
limit: 20
include_comments: true
Monitor mentions during potential PR issues.

​
Time period options

  • “0”: Today only
  • “1”: Last 24 hours
  • “7”: Last week (default)
  • “30”: Last month
  • “90”: Last 3 months
  • “180”: Last 6 months

​
What you get back

  • Video Description: The text description of each TikTok video
  • Creator Info: Username and profile details
  • Engagement Metrics: View count, likes, comments, shares
  • Video URL: Direct link to the TikTok video
  • Top Comments: Most engaging comments (if enabled)
  • Comment Engagement: Like counts for comments

​
Best practices

  • Use hashtags (#) for trending topic searches
  • Include brand names without # for brand monitoring
  • Try different time periods based on content freshness needs
  • Enable comments for sentiment analysis
  • Use specific keywords for targeted results
  • Monitor multiple related terms for comprehensive coverage

​
Troubleshooting

“No results found”
  • Try broader search terms or different hashtags
  • Extend the time period to find more content
  • Check if the search term is spelled correctly
“Limited results”
  • Some topics may have less TikTok content
  • Try related keywords or hashtags
  • Extend the time period for more results
“Search failed”
  • Verify internet connectivity
  • Try simpler search terms
  • Check if TikTok is accessible in your region