TikTok Hashtag Scraper Scrape videos from specific TikTok hashtags or challenges to analyze trends and track campaigns. ## Use Cases - Hashtag Research: Analyze performance of specific hashtags - Campaign Tracking: Monitor branded hashtag campaigns - Trend Analysis: Study what content performs well in a hashtag - Competitor Research: See how competitors use hashtags - Content Discovery: Find content in your niche - Influencer Outreach: Identify active creators in hashtags ## Input ### Parameters | Field | Type | Required | Description | Example | Default | | ------------ | ------ | -------- | ------------------------ | --------------------- | ------- | | hashtag | string | Yes | Hashtag name (without #) | pizza | - | | type | string | Yes | Scraper type | hashtag | - | | maxResults | number | No | Maximum videos to scrape | 100 | 20 | | cursor | string | No | Pagination cursor | 0_1234567890_abcdef | - | ### Example: Basic Hashtag Scrape json { "hashtag": "pizza", "type": "hashtag", "maxResults": 50 } ### Example: Challenge Scrape json { "hashtag": "pizzachallenge", "type": "hashtag", "maxResults": 100 } ### Example: Paginated Request json { "hashtag": "pizza", "type": "hashtag", "maxResults": 50, "cursor": "0_1733644800_xyz123" } ## Output ### Schema json { "challenge": { "id": "7090", "title": "pizza", "desc": "Show us your favorite pizza moments! 🍕", "stats": { "videoCount": 2847956, "viewCount": 8932045821 } }, "videos": [ { "id": "7480901866377858326", "desc": "New York pizza hits different 🍕 #pizza", "createTime": 1733644829, "video": { "duration": 12, "cover": "https://...", "playAddr": "https://..." }, "author": { "uniqueId": "malatidipizza", "nickname": "Malati Di Pizza", "verified": true }, "stats": { "diggCount": 327000, "shareCount": 8945, "commentCount": 2341, "playCount": 7700000 } } ], "cursor": "0_1733644800_xyz123", "hasMore": true, "scrapedAt": "2024-12-08T04:50:29.000Z", "totalScraped": 50 } ### Output Fields | Field | Type | Description | | -------------- | ------- | -------------------------- | | challenge | object | Hashtag/challenge details | | videos | array | Videos using the hashtag | | cursor | string | Cursor for next page | | hasMore | boolean | More videos available | | totalScraped | number | Videos in current response | ## Pagination To scrape more videos: 1. First Request: Omit cursor parameter 2. Check Response: Look at hasMore field 3. Next Request: Use returned cursor value 4. Repeat: Until hasMore is false ### Pagination Example json // Request 1 { "hashtag": "pizza", "type": "hashtag", "maxResults": 100 } // Response: cursor = "0_1733644800", hasMore = true // Request 2 { "hashtag": "pizza", "type": "hashtag", "maxResults": 100, "cursor": "0_1733644800" } ## Usage Tips ### Hashtag Selection - Use exact hashtag names (no # symbol) - Case-insensitive (Pizza = pizza) - Works for both hashtags and challenges - Check stats before bulk scraping ### Best Practices - Start with small maxResults (20-50) - Use pagination for large datasets - Add 2-3 second delays between requests - Cache challenge details (updates slowly) ## Error Handling | Error Code | Description | Solution | | ---------- | ------------------- | --------------------------- | | 404 | Hashtag not found | Verify hashtag exists | | 400 | Invalid cursor | Start fresh without cursor | | 429 | Rate limit exceeded | Add delays between requests | --- Last Updated: December 8, 2024