> ## Documentation Index > Fetch the complete documentation index at: https://docs.sociavault.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Popular Hashtags > Get popular TikTok hashtags with filtering by time period and country. Optionally surface only newly trending hashtags. **Credit Cost:** 1 credit per request 💳 **1 credit** per request ## OpenAPI ````yaml GET /v1/scrape/tiktok/hashtags/popular openapi: 3.1.0 info: title: SociaVault API version: 1.0.0 description: >- # SociaVault API Documentation The SociaVault API provides comprehensive access to social media data extraction across multiple platforms. ## Features - **Multi-Platform Support**: TikTok, Instagram, YouTube, Facebook, Twitter, Reddit, Threads, and more - **Credit-Based System**: Pay-as-you-go pricing with transparent credit costs - **High Performance**: Fast, reliable data extraction - **Comprehensive Data**: Detailed user profiles, videos, posts, comments, and analytics ## Authentication All API requests require authentication using an API key in the `X-API-Key` header: ```bash X-API-Key: sk_live_your_api_key_here ``` Get your API key from the [SociaVault Dashboard](https://sociavault.com/dashboard). ## Credits Each endpoint consumes credits based on data complexity: - Simple requests (profiles): 1 credit - Complex requests (demographics): 20+ credits - Paginated requests: Credits per page Check your credit balance in the dashboard or via the API. ## Support - **Documentation**: https://docs.sociavault.com - **Email**: support@sociavault.com - **Discord**: https://discord.gg/sociavault contact: name: SociaVault Support email: support@sociavault.com url: https://sociavault.com/support license: name: Commercial url: https://sociavault.com/terms servers: - url: https://api.sociavault.com description: Production API security: - ApiKeyAuth: [] tags: - name: account description: Account management and credit balance externalDocs: description: Learn more url: https://docs.sociavault.com/account - name: tiktok description: Scrape TikTok profiles, videos, and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/tiktok - name: tiktok-shop description: Everything about TikTok Shop externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/tiktok-shop - name: instagram description: Gets Instagram profiles, posts, and reels externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/instagram - name: youtube description: Scrape YouTube channels, videos, and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/youtube - name: linkedin description: Scrape LinkedIn externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/linkedin - name: facebook description: Get public Facebook profiles and posts externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebook - name: facebookAdLibrary description: Scrapes the Facebook (Meta) Ad Library externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebookAdLibrary - name: facebookMarketplace description: Search Facebook Marketplace and pull full listing details externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebookMarketplace - name: googleAdLibrary description: >- Scrape the Google Ad Transparency Library. *This only gets the public ads. Some ads you need to log in for and sadly we can't get those. Also, since there are so many variations, the return types might not all be 100% the same. externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/googleAdLibrary - name: linkedinAdLibrary description: Search the LinkedIn Ad Library externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/linkedinAdLibrary - name: twitter description: Get Twitter profiles, tweets, followers and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/twitter - name: reddit description: Scrape Reddit posts and comments externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/reddit - name: threads description: Get Threads posts externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/threads - name: google description: Scrape Google search results externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/google paths: /v1/scrape/tiktok/hashtags/popular: get: tags: - tiktok summary: Popular Hashtags description: >- Get popular TikTok hashtags with filtering by time period and country. Optionally surface only newly trending hashtags. **Credit Cost:** 1 credit per request operationId: tiktok_Popular_Hashtags parameters: - name: period in: query description: Time period in days (7, 30, or 120) required: false schema: type: integer enum: - 7 - 30 - 120 example: 7 - name: page in: query description: Page number required: false schema: type: integer example: 1 - name: countryCode in: query description: Country code to get popular hashtags from required: false schema: type: string enum: - AU - BR - CA - EG - FR - DE - ID - IL - IT - JP - MY - PH - RU - SA - SG - KR - ES - TW - TH - TR - AE - GB - US - VN example: US - name: newOnBoard in: query description: Show only newly trending hashtags required: false schema: type: boolean example: false responses: '200': description: >- Successful response **Key Response Fields:** - `data.list[].hashtag_id`: Unique hashtag ID - `data.list[].hashtag_name`: The hashtag text (without `#`) - `data.list[].publish_cnt`: Total number of videos published with this hashtag - `data.list[].video_views`: Total video views across all posts using this hashtag - `data.list[].rank`: Current position on the chart - `data.list[].rank_diff`: Change in rank since last period (`0` = no change) - `data.list[].rank_diff_type`: Type of rank change (e.g. `2` = stable) - `data.list[].is_promoted`: Whether the hashtag is being promoted - `data.list[].country_info.id`: 2-letter country code (e.g. `US`) - `data.list[].country_info.value`: Full country name (e.g. `United States`) - `data.list[].industry_info.id`: Industry category ID - `data.list[].industry_info.value`: Industry name (e.g. `Apparel & Accessories`) - `data.list[].trend[]`: Popularity trend over time — each entry has `time` (Unix timestamp) and `value` (relative popularity 0–1) - `data.pagination.page`: Current page number - `data.pagination.size`: Items per page - `data.pagination.total`: Total number of hashtags available - `data.pagination.has_more`: Whether more pages exist content: application/json: example: success: true data: success: true list: '0': hashtag_id: '7157084587318280197' hashtag_name: tiktokshopblackfriday country_info: id: US value: United States label: US industry_info: id: 22000000000 value: Apparel & Accessories label: label_22000000000 is_promoted: false trend: '0': time: 1761350400 value: 0.4 '1': time: 1761955200 value: 0.5 '2': time: 1762560000 value: 0.64 '3': time: 1763164800 value: 0.82 '4': time: 1763769600 value: 0.95 '5': time: 1764374400 value: 1 '6': time: 1764979200 value: 0.68 '7': time: 1765584000 value: 0.42 '8': time: 1766188800 value: 0.34 '9': time: 1766793600 value: 0.29 '10': time: 1767398400 value: 0.24 '11': time: 1768003200 value: 0.23 '12': time: 1768608000 value: 0.2 '13': time: 1769212800 value: 0.18 '14': time: 1769817600 value: 0.15 publish_cnt: 6928523 video_views: 34159952334 rank: 1 rank_diff: 0 rank_diff_type: 2 pagination: page: 1 size: 20 total: 100 has_more: true credits_used: 1 endpoint: tiktok/hashtags/popular '402': description: Insufficient credits content: application/json: schema: type: object properties: error: type: string example: Insufficient credits required: type: integer example: 1 available: type: integer example: 0 '500': description: Server error content: application/json: schema: type: object properties: error: type: string example: Failed to fetch popular TikTok hashtags components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: |- API key for authentication. Format: `sk_live_xxxxxxxxxxxxx` Get your API key from the [Dashboard](https://sociavault.com/dashboard). ````